Chương 15 : Khả năng liên tác và mã lệnh không được quản lý Microsoft .NET Framework là một nền cực kỳ cao vọng, là sự kết hợp của một ngôn ngữ mới (C#), một bộ thực thi được-quản-lý (CLR), một nền cho các ứng dụng Web (Microsoft ASP.NET), và một thư viện lớp rất lớn để xây dựng tất cả các kiểu ứng dụng. Tuy nhiên, .NET Framework không lặp lại các tính n ăng có trong mã lệnh không-được- quản-lý. Hiện thời, .NET Framework không bao gồm mọi hàm có trong Win32 API, trong khi nhiều doanh nghiệp đang sử dụng các giải pháp phức tạp được xây dựng với các ngôn ngữ dựa-trên-COM như Microsoft Visual Basic 6 và Microsoft Visual C++ 6. May mắn là Microsoft không có ý để những doanh nghiệp đó bỏ đi nền tảng mã lệnh mà họ đã xây dựng khi chuyển sang nền .NET. Thay vào đó, .NET Framework được trang bị v ới các tính năng interoperability (khả năng liên tác), cho phép bạn sử dụng lại mã lệnh cũ (legacy code) trong các ứng dụng .NET Framework và truy xuất các assembly .NET như thể chúng là các thành phần COM. Chương này sẽ thảo luận các vấn đề sau:  Cách gọi các hàm thuộc DLL không-được-quản-lý (mục 15.1 đến 15.5).  Cách sử dụng thành phần COM trong ứng dụng .NET Framework (mục 15.6 đến 15.8).  Cách sử dụng điều kiểm ActiveX trong ứng dụng .NET Framework (mục 15.9).  Cách tạo một thành phần .NET sao cho một COM-client có thể sử dụng nó (mục 15.10). 1.1 Gọi một hàm trong một DLL không-được-quản-lý V V Bạn cần gọi một hàm C trong một DLL. Đây có thể là một hàm của Win32 API hoặc do bạn viết. # # Khai báo một phương thức trong mã C# mà bạn sẽ sử dụng để truy xuất hàm không-được-quản-lý. Khai báo phương thức này là static và extern, áp dụng đặc tính System.Runtime.InteropServices.DllImportAttribute để chỉ định file DLL và tên của hàm cần dùng. Để sử dụng một hàm C từ một thư viện ngoài, bạn chỉ cần khai báo nó một cách thích hợp. CRL sẽ tự động đảm trách phần việc còn lại, bao gồm việc tải DLL vào bộ nhớ khi hàm được gọi và chuyển các thông số từ kiểu dữ liệu .NET thành kiểu dữ liệu C. Dịch vụ .NET hỗ trợ việc thực thi xuyên-nền này có tên là PInvoke (Platform Invoke), và quá trình này thường là trong suốt đối với người sử dụng. Thỉnh thoảng, bạn sẽ cần thực hiện thêm một số việc, chẳng hạn cần hỗ trợ cấu trúc trong-bộ-nhớ ( in-memory structure), callback, hay chuỗi có thể thay đổi (mutable string). PInvoke thường được sử dụng để truy xuất các hàm Win32 API, đặc biệt là các tính năng không có trong các lớp được-quản-lý thuộc .NET Framework. Các ví dụ được trình bày trong chương này sẽ sử dụng PInvoke theo cách này. Có ba thư viện chính trong Win32 API: • kernel32.dll⎯gồm các hàm đặc-trưng-hệ-điều-hành như nạp tiến trình, chuyển ngữ cảnh, nhập/xuất file và bộ nhớ. • user32.dll⎯gồm các hàm dùng để thao tác cửa sổ, trình đơn, hộp thoại, biểu tượng,… • gdi32.dll⎯gồm các hàm đồ họa dùng để để vẽ trực tiếp lên cửa sổ, trình đơn, bề mặt điều kiểm, cũng như để in ấn. Ví dụ, xét các hàm Win32 API dùng để đọc và ghi các file INI, chẳng hạn GetPrivateProfileString và WritePrivateProfileString trong kernell32.dll. .NET Framework không có lớp nào bọc lấy chức năng này. Tuy nhiên, có thể nhập các hàm này bằ ng đặc tính DllImportAttribute như sau: [DllImport("kernel32.DLL", EntryPoint="WritePrivateProfileString")] private static extern bool WritePrivateProfileString(string lpAppName, string lpKeyName, string lpString, string lpFileName); Các đối số trong phương thức WritePrivateProfileString phải tương thích với hàm trong DLL, nếu không sẽ có lỗi khi gọi nó. Vì phương thức WritePrivateProfileString được khai báo để tham chiếu đến một hàm trong DLL nên bạn không được viết mã cho nó. Phần EntryPoint trong đặc tính DllImportAttribute trong ví dụ này là tùy chọn, vì tên phương thức được khai báo đã trùng với tên của hàm trong thư viện ngoài. Trong ví dụ sau, lớp IniFileWrapper khai báo các phương thức riêng tham chiếu tới các hàm Win32 API, sau đó gọi chúng từ các phương thức công khai khác dự a trên file được chỉ định: using System; using System.Text; using System.Runtime.InteropServices; using System.Windows.Forms; public class IniFileWrapper { private string filename; public string Filename { get {return filename;} } public IniFileWrapper(string filename) { this.filename = filename; } [DllImport("kernel32.dll", EntryPoint="GetPrivateProfileString")] private static extern int GetPrivateProfileString(string lpAppName, string lpKeyName, string lpDefault, StringBuilder lpReturnedString, int nSize, string lpFileName); [DllImport("kernel32.dll", EntryPoint="WritePrivateProfileString")] private static extern bool WritePrivateProfileString( string lpAppName, string lpKeyName, string lpString, string lpFileName); // Bốn hàm sau không được sử dụng trong ví dụ này, // nhưng được khai báo cho đầy đủ. [DllImport("kernel32.dll", EntryPoint="WritePrivateProfileInt")] private static extern int GetPrivateProfileInt(string lpAppName, string lpKeyName, int iDefault, string lpFileName) ; [DllImport("kernel32.dll", EntryPoint="GetPrivateProfileSection")] private static extern int GetPrivateProfileSection( string lpAppName, byte[] lpReturnedString, int nSize, string lpFileName); [DllImport("kernel32.dll", EntryPoint="WritePrivateProfileSection")] private static extern bool WritePrivateProfileSection( string lpAppName, byte[] data, string lpFileName); [DllImport("kernel32.dll", EntryPoint="GetPrivateProfileSectionNames")] private static extern int GetPrivateProfileSectionNames( byte[] lpReturnedString, int nSize, string lpFileName); public string GetIniValue(string section, string key) { StringBuilder buffer = new StringBuilder(); string sDefault = ""; if (GetPrivateProfileString(section, key, sDefault, buffer, buffer.Capacity, filename) != 0) { return buffer.ToString(); } else { return null; } } public bool WriteIniValue(string section, string key, string value) { return WritePrivateProfileString(section, key, value, filename); } } Í Phương thức GetPrivateProfileString có một thông số thuộc kiểu StringBuilder (lpReturnedString). Đó là vì chuỗi này phải là khả đổi—khi lời gọi hàm hoàn tất, nó sẽ chứa thông tin của file INI. Bất cứ khi nào cần chuỗi khả đổi, bạn phải sử dụng StringBuilder thay cho String. Thông thường, bạn cần tạo StringBuilder với một bộ đệm ký tự có kích thước xác định, rồi truyền kích thước này (nSize) cho phương thức. Bạn có thể chỉ đị nh số lượng ký tự trong phương thức khởi dựng của StringBuilder (xem mục 2.1 để có thêm thông tin về StringBuilder). Để thử nghiệm lớp IniFileWrapper, bạn hãy tạo một file INI chứa thông tin sau: [SampleSection] Key1=Value1 Key2=Value2 Key3=Value3 Và thực thi đoạn mã sau để đọc và ghi một giá trị trong file INI. public class IniTest { private static void Main() { IniFileWrapper ini = new IniFileWrapper( Application.StartupPath + "\\initest.ini"); string val = ini.GetIniValue("SampleSection", "Key1"); Console.WriteLine("Value of Key1 in [SampleSection] is: " + val); ini.WriteIniValue("SampleSection", "Key1", "New Value"); val = ini.GetIniValue("SampleSection", "Key1"); Console.WriteLine("Value of Key1 in [SampleSection] is now: " + val); ini.WriteIniValue("SampleSection", "Key1", "Value1"); Console.ReadLine(); } } 1.2 Lấy handle của một điều kiểm, cửa sổ, hoặc file V V Bạn cần gọi một hàm không-được-quản-lý, và hàm này cần handle của một điều kiểm, cửa sổ, hoặc file. # # Nhiều lớp, bao gồm lớp FileStream và tất cả lớp dẫn xuất từ Control, trả về handle (thuộc cấu trúc IntPtr) thông qua thuộc tính Handle. Cũng có lớp trả về thông tin tương tự; ví dụ, lớp System.Diagnostics.Process có thêm thuộc tính Process.MainWindowHandle ngoài thuộc tính Handle. .NET Framework không che dấu các chi tiết nằm dưới, chẳng hạn handle dùng cho cửa sổ và điều kiểm. Mặc dù không thường sử dụng thông tin này, bạn có thể lấy nó khi cần gọi mộ t hàm không-được-quản-lý và hàm này cần đến nó. Xét ứng dụng dưới đây, form chính luôn hiển thị trên tất cả các cửa sổ khác bất kể nó có focus hay không (có được chức năng này bằng cách thiết lập thuộc tính Form.TopMost là true). Form còn có một Timer định kỳ gọi các hàm không-được-quản-lý GetForegroundWindow và GetWindowText để lấy thông tin của cửa sổ hiện đang có focus. Ngoài ra, handle của form chính được lấy thông qua thuộc tính Form.Handle, rồi được so sánh với handle của form hiện đang tích cực để kiểm tra form chính đang có focus hay không. Hình 15.1 Thông tin về cửa sổ đang tích cực using System; using System.Windows.Forms; using System.Runtime.InteropServices; The image part with relationsh ip ID rI d5 was not fo und in the file. The image part with relationship I D rId6 was no t found in the file. using System.Text; public class ActiveWindowInfo : System.Windows.Forms.Form { // (Bỏ qua phần mã designer.) private System.Windows.Forms.Timer tmrRefresh; private System.Windows.Forms.Label lblCurrent; private System.Windows.Forms.Label lblHandle; private System.Windows.Forms.Label lblCaption; [DllImport("user32.dll")] private static extern int GetForegroundWindow(); [DllImport("user32.dll")] private static extern int GetWindowText(int hWnd, StringBuilder text, int count); private void tmrRefresh_Tick(object sender, System.EventArgs e) { int chars = 256; StringBuilder buff = new StringBuilder(chars); int handle = GetForegroundWindow(); if (GetWindowText(handle, buff, chars) > 0) { lblCaption.Text = buff.ToString(); lblHandle.Text = handle.ToString(); if (new IntPtr(handle) == this.Handle) { lblCurrent.Text = "True"; } else { lblCurrent.Text = "False"; } } } } Í Handle của form được quản lý một cách trong suốt đối với người dùng. Thay đổi thuộc tính nào đó của form có thể khiến cho CRL tạo một handle mới. Do đó, bạn nên luôn truy xuất handle ngay trước khi sử dụng nó (không nên giữ nó trong một biến để sử dụng trong một thời gian dài). 1.3 Gọi một hàm không-được-quản-lý có sử dụng cấu trúc V V Bạn cần gọi một hàm không-được-quản-lý có thông số là một cấu trúc. # # Định nghĩa cấu trúc trong mã C#. Sử dụng đặc tính System.Runtime.InteropServices.StructLayoutAttribute để cấu hình việc cấp bộ nhớ cho cấu trúc. Sử dụng phương thức tĩnh SizeOf của lớp System.Runtime.Interop.Marshal nếu muốn xác định kích thước của cấu trúc theo byte. Trong mã C# thuần túy, bạn không có khả năng trực tiếp kiểm soát việc cấp bộ nhớ. Thay vào đó, CRL sẽ quyết định khi nào cần đưa dữ li ệu vào bộ nhớ để tối ưu hóa hoạt động. Điều này gây rắc rối khi làm việc với các hàm C, vì cấu trúc phải được trữ liên tục trong bộ nhớ. May mắn là .NET đã giải quyết vấn đề này bằng đặc tính StructLayoutAttribute, cho phép bạn chỉ định các thành viên của một lớp hay một cấu trúc cho trước sẽ được sắp xếp trong bộ nhớ như thế nào. Ví dụ , xét hàm GetVersionEx trong thư viện kernel32.dll. Hàm này nhận một con trỏ chỉ tới cấu trúc OSVERSIONINFO và sử dụng nó để trả về thông tin phiên bản của hệ điều hành. Để sử dụng cấu trúc OSVERSIONINFO trong mã C#, bạn phải định nghĩa nó với đặc tính StructLayoutAttribute như sau: [StructLayout(LayoutKind.Sequential)] public class OSVersionInfo { public int dwOSVersionInfoSize; public int dwMajorVersion; public int dwMinorVersion; public int dwBuildNumber; public int dwPlatformId; [MarshalAs(UnmanagedType.ByValTStr, SizeConst=128)] public String szCSDVersion; } Chú ý rằng, cấu trúc này cũng sử dụng đặc tính System.Runtime.InteropServices. MarshalAsAttribute (cần cho các chuỗi có kích thước không đổi). Ở đây, MarshalAsAttribute chỉ định chuỗi sẽ được truyền bằng trị và sẽ chứa một bộ đệm gồm 128 ký tự được chỉ định trong cấu trúc OSVersionInfo. Trong ví dụ này, LayoutKind.Sequential được sử dụng, nghĩa là các kiểu dữ liệu trong cấu trúc được bố trí theo thứ tự mà chúng được liệt kê trong cấu trúc hoặ c lớp. Ngoài LayoutKind.Sequential, bạn có thể sử dụng LayoutKind.Explicit. Trong trường hợp này, bạn phải sử dụng FieldOffsetAttribute để định nghĩa độ dời của các trường. Cách này hữu ích khi bạn muốn lưu trữ các trường một cách linh động hơn, hoặc bạn muốn bỏ qua (không sử dụng) trường nào đó. Ví dụ sau định nghĩa lớp OSVersionInfo với LayoutKind.Explicit. [StructLayout(LayoutKind.Explicit)] public class OSVersionInfo { [FieldOffset(0)] public int dwOSVersionInfoSize; [FieldOffset(4)] public int dwMajorVersion; [FieldOffset(8)] public int dwMinorVersion; [FieldOffset(12)] public int dwBuildNumber; [FieldOffset(16)] public int dwPlatformId; [MarshalAs(UnmanagedType.ByValTStr, SizeConst=128)] [FieldOffset(20)] public String szCSDVersion; } Sau khi đã định nghĩa cấu trúc được sử dụng bởi hàm GetVersionEx, bạn có thể khai báo hàm này và sử dụng nó. Ứng dụng dưới đây sẽ trình bày toàn bộ mã lệnh cần thiết. Chú ý, InAttribute và OutAttribute được áp dụng cho OSVersionInfo để biết rằng marshalling sẽ được thực hiện trên cấu trúc này khi nó được truyền cho hàm và khi nó được trả về từ hàm. Ngoài ra, phương thức Marshal.SizeOf được sử dụng để tính kích thước của cấu trúc trong bộ nhớ . . Chương 15 : Khả năng liên tác và mã lệnh không được quản lý Microsoft .NET Framework là một nền cực kỳ cao vọng, là. tảng mã lệnh mà họ đã xây dựng khi chuyển sang nền .NET. Thay vào đó, .NET Framework được trang bị v ới các tính năng interoperability (khả năng liên tác) ,