visual|xml
Visual Studio.net中的XML注释10/18/2001 11:1:33· · ··YESKY
介绍
在这个实践练习中，你将在C#源文件中插入XML注释，然后通过C#编译器生成XML文件。你可以在C#源代码中使用XML相关的注释标记，这些标记被用来指明哪些注释需要输出到XML文件。
XML文件可以作为代码文档。你可以在现存的文件中加入新的注释，或者修改现有注释，以保持文档和它对应代码的一致性。为了创建一个更新的文档记录，你要重新生成XML文件。
在本练习中，你将要:
· 使用微软Visual Studio.NET集成开发环境创建和编辑一个项目文件
· 创建一个XML文件(doc.xml)
· 在IDE中打开项目和源文件
· 用MS-DOS命令编译项目
· 在XML文件中应用XSL模板
· 打开doc.xml最终版本
在IDE中创建一个新的项目
1．点击Start，点击Programs，点击Microsoft Visual Studio.NET7.0，然后再点击Microsoft Visual Studio .NET 7.0。IDE启动页面就会显示，如图1。
图1 Visual Studio.NET IDE启动页面
注意：
当你用这种方法启动IDE时，缺省启动页面就会打开。它提供了在此工作环境下的最近四个项目的链接，还提供了一些其它资源的链接。
你可以改变你的缺省设置。点击Tools，再点击Options，然后选择你喜欢的设置。
2．点击File，点击New，再点击Project。New Project窗口就会出现，如图2。
3．在Project Types面板里点击Visual C# Projects，在Templates面板上中点击Empty Project。
4．在Name字段中，键入XML Comments，然后选择你的项目存放的位置(在本操作中我们使用缺省位置)。
注意：在这个项目名中,"XML"与"Comments"中间有一个空格。
5．点击OK。
图2. New Project窗口 创建XMLComment.cs源文件
XMLComment.cs文件是用来创建XML文档的源文件。XML标签及其相关文本在C#代码中被注释掉了。此源文件在编译时，就通过这些XML标签和文本生成XML文档。
注意：
XML注释标记是新加入C#的。在文本前面以三斜杠（///）打头，它会告诉编译器斜杠后面的文本是XML注释。我们必须以三斜杠开头以声明这一行为XML注释行。XML注释必须采用XML标签的格式，这样才能生成XML文档。
1．点击File，再点击Add New Item。Add New Item窗口将显示如图3。
2．在Categories面板里点击Local Project Items，在Templates面板中点击Code File。
3．在name字段中键入XMLComment.cs。
注意："XMLComment.cs"中间没有空格.
图3.Add New Item窗口
4．点击Open.
5．在页面中敲入下面的代码：
using System;
class XmlElement
{
///
/// Returns the attribute with the given name and
/// namespace
///
/// The name of the attribute
///
/// The namespace of the attribute, or null if
/// the attribute has no namespace
///
/// The attribute value, or null if the attribute
/// does not exist
///
public string GetAttr(string name, string ns) {
return "test";
}
}
6．点击File，再点击Save XMLComments.cs（或点击Save图标）。该文件就被存到你的项目文件夹中。
7．点击File，再点击Exit。如果Microsoft Development窗口出现，点击Yes保存你的项目。
在IDE中打开项目和源文件
1．点击Start，点击Programs，点击Microsoft Visual Studio.NET7.0，然后再点击Microsoft Visual Studio .NET 7.0。
2．点击File，点击Open，再点击Project。
3．打开路径C:\Documents and Settings\Administrator\My Documents\Visual Studio Projects\XMLComments
4．点击XMLComments.csproj或XMLComments.sln，然后点击Open。
注意：点击两个中的任何一个文件都可以打开项目
如果在主窗口中没有打开源文件，在Solution Explorer窗口中双击XMLComments.cs.(见图4)。源文件就会在主窗口中打开。保持IDE的打开状态，y以完成下面的步骤.
图4.XMLComment.cs文档在IDE中的视图
注意：System名字空间（namespaces）被声明在在文件顶端。所以这个名字空 间中的所有类在XmlElement类中可用。
XML元素"param"有两个属性，name和ns。我们把这些属性值作为参数传递给GetAttr()。
编译
在本章中，你将使用两个现存的文件，make.bat 和doc.xsl。这些文件必须存放在XMLComments项目文件夹中，此项目才能被正确编译。
注意：doc.xsl文件提供了类型表模板，用以在Web浏览器中显示doc.xml文件。make.bat文件包含C#编译选项。
1．点击Start，点击Programs，点击Accessories，再点击Windows Exployer。
2．打开路径C:\FieldContent\Experience VS.NET\Lab2。
3．高亮选中文件doc.xsl和make.bat，点击Edit，再点击Copy。
4．打开路径C:\Documents and Settings\Administrator\My Documents\Visual Studio Projects\XMLComments。
5．点击Edit，再点击Paste将文件粘贴到XMLComments文件夹中。你将使用MS-DOS命令行来编译这个项目。
6．在Windows Explorer中，打开路径C:\FieldContent\Experience VS.NET\Lab2。
7．双击Command Prompt。
8．敲入type make.bat，然后按回车键。屏幕上会显示make.bat file文件的内容。
注意：make.bat file文件包含下面的参数：
csc命令调用了C#编译器
/ target选项具体指明输出文件的格式。在这个例子里，它是一个库文， 即dll（XMLComment.dll）。
/doc选项告诉编译器从源文件的文档注释中创建一个XML文件(doc.xml)
XMLComment.cs是需编译的源文件。
9．键入make，然后按回车键。命令行提示窗口就会显示如图5。
注意：当使用make命令编译结束后，doc.xml XMLComment.dll文件就被创建了。并且它们会被自动存放到XMLCommand项目文件夹中。对于C#来说，这是缺省的。你不必指明存储路径除非你想改变它。
图5.生成doc.xml后的DOS命令窗口
10．关闭命令提示.
doc.xsl的下载地址：http://msdn.microsoft.com/code/default.asp?url=/code/sample.asp?url=/msdn-files/027/001/686/msdncompositedoc.xml