686
Phụ lục A: Giới thiệu một số công cụ .NET
Hình A-6 Khảo sát NUnitExample với .NET Reflector
Đoạn mã trên rất giống với đoạn mã mà chúng ta đã viết:
public void HashtableAddTest()
{
Hashtable ht = new Hashtable();
ht.Add("Key1", "Value1");
ht.Add("Key2", "Value2");
Assert.AreEqual("Value1", ht["Key1"],"Wrong object returned!");
Assert.AreEqual("Value2", ht["Key2"],"Wrong object returned!");
}
Mặc dù có một vài khác biệt nhỏ về mã lệnh nhưng chúng giống hệt nhau về chức năng.
Công dụng hay nhất của .NET Reflector là khảo sát các assembly và phương thức của .NET
Framework. .NET Framework cung cấp nhiều cách khác nhau để thực hiện các thao tác tương
tự nhau. Ví dụ, nếu bạn cần đọc một tập dữ liệu từ XML, có nhiều cách khác nhau để thực
hiện điều này: sử dụng
XmlDocument
,
XPathNavigator
, hay
XmlReader
. Bằng cách sử dụng
.NET Reflector, bạn có thể xem Microsoft đã sử dụng gì khi viết phương thức
ReadXml
của
DataSet
, hoặc họ đã làm gì khi đọc dữ liệu từ file cấu hình. .NET Reflector cũng rất có ích khi
tìm hiểu cách tạo các đối tượng như
HttpHandlers
; và qua đó, bạn biết được cách thức mà
nhóm phát triển của Microsoft đã xây dựng các đối tượng đó trong Framework.
.NET Reflector được viết bởi Lutz Roeder và có thể được download tại
[
http://www.aisto.com/roeder/dotnet]
.
A.7 Lập tài liệu mã lệnh với NDoc
A.7 Lập tài liệu mã lệnh với NDoc
Việc lập tài liệu mã lệnh gần như là một công việc không mấy hứng thú. Ở đây không nói về
tài liệu thiết kế mà là tài liệu cho từng phương thức và thuộc tính của lớp. Công cụ NDoc sẽ sẽ
tự động sinh tài liệu cho mã lệnh của bạn bằng cách sử dụng cơ chế phản chiếu để khảo sát
assembly và sử dụng file XML được sinh từ các chú thích XML C# (các chú thích XML chỉ có
hiệu lực cho C#, nhưng có một Visual Studio .NET Power Toy với tên là VBCommenter cũng
sẽ thực hiện giống như vậy đối với Visual Basic .NET).
Với NDoc, bạn vẫn cứ lập tài liệu cho mã lệnh, nhưng lập khi viết mã (trong các chú thích
XML). Bước đầu tiên khi sử dụng NDoc là mở chức năng sinh chú thích XML đối với
assembly của bạn. Nhắp phải vào dự án và chọn Properties | Configuration Properties | Build,
rồi nhập một đường dẫn để lưu file XML trong tùy chọn XML Documentation File (xem hình
A-7). Khi dự án được tạo dựng, một file XML sẽ được sinh ra với tất cả các chú thích XML đi
kèm.
