DIV CSS 佈局教程網

 DIV+CSS佈局教程網 >> 網頁腳本 >> XML學習教程 >> XML詳解 >> 在C#使用XML注釋 - asp.net
在C#使用XML注釋 - asp.net
編輯:XML詳解     
大多數程序員可能都聽說過Java自帶的一個工具JavaDoc;使用它可以自動地為你的代碼生成HTML文檔。C#和C#編譯器也有類似的功能,不過它生成的是XML,而不是直接生成Html。不過使用XML會使得文檔更加靈活。

注釋語法

為了使用C#提供的XML注釋功能,你的注釋應該使用特殊的注釋語法(///)開頭。在///之後,你可以使用預先定義的標簽注釋你的代碼,也可以插入你自己定義的標簽。你定制的標簽將會在隨後加入到生成的注釋文檔中。

預定義的標簽 用處

<c> 將說明中的文本標記為代碼

<code> 提供了一種將多行指示為代碼的方法

<example> 指定使用方法或其他庫成員的示例

<exception> 允許你指定可能發生的異常類

<include> 允許你引用描述源代碼中類型和成員的另一文件中的注釋, 使用 XML XPath 語法來描述你的源代碼中的類型和成員。

<list> 向XML注釋文檔中插入一個列表

<para> 向XML注釋文檔中插入一個段落

<param> 描述一個參數

<paramref> 提供了一種指示一個詞為參數的方法

<permission> 允許你將成員的訪問許可加入到文檔中

<remarks> 用於添加有關某個類型的信息

<returns> 描述返回值

<see> 指定鏈接

<seealso> 指定希望在“請參見”一節中出現的文本

<summary> 類型或類型成員的通用描述

<value> 描述屬性




例子

下面的例子為我們常見的HelloWorld控制台應用程序添加注釋:

using System;

namespace HelloWorld
{
/// <summary>
/// Sample Hello World in C#
/// </summary>
public class HelloWorld
{
/// <summary>
/// Console Application Entry Point
/// <param name="args">Command Line Arguments</param>
/// <returns>Status code of 0 on successful run</returns>
/// </summary>
public static int Main(string[] args)
{
System.Console.WriteLine("HelloWorld");
string name = System.Console.ReadLine();

return(0);
}
}
}


為生成XML注釋文檔,我們在調用csc編譯源代碼時使用/doc選項:

csc /doc:HelloWorld.XML helloworld.cs


生成的結果文檔如下:

<?XML version="1.0"?>

<doc>

<assembly>

<name>XMLComment</name>

</assembly>

<members>

<member name="T:HelloWorld.HelloWorld">

<summary>

Sample Hello World in C#

</summary>

</member>

<member name="M:HelloWorld.HelloWorld.Main(System.String[])">

<summary>

Console Application Entry Point

<param name="args">Command Line Arguments</param>

<returns>Status code of 0 on successful run</returns>

</summary>

</member>

</members>

</doc>




Html頁面

你可能會問自己:我應該如何才能得到具有良好格式的HTML頁面呢?很簡單,你可以編寫自己的XSL來轉換生成的XML注釋文檔,或者使用Visual Studio.NET開發工具。通過使用VS.NET的【工具】菜單中的【生成注釋web頁】,你可以得到一系列詳細說明你的項目或解決方案的Html頁面。下面就是通過VS.Net生成的注釋helloWorld程序的Html頁面快照:

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved