介绍
在这个实践练习中，你将在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．关闭命令提示.
在XML文件中应用XSL模板
你现在将要把XSL模板应用于你创建的XML文件。你要在IDE中打开XML和XSL文件，然后再应用XSL模板，这样XML.doc才可以正确地在Web浏览器中显示。
1．在IDE中，点击File，再点击Add Existing Item。
2．打开路径C:\Documents and Settings\Administrator\My Documents\Visual Studio Projects\XMLComments.
3．点击doc.xml，再按Open按钮。doc.xml文件将在IDE中打开，如图6。
图6. IDE中的Doc.xml
你现在可以在Web浏览器上打开doc.xml原始文件
4．点击View，再点击Open With。
5．点击IExplore.exe，再点击Open。Doc.xml原始文件就在Microsoft Internet Explorer中打开，如图7。
注意：Internet Explorer用一系列"-"符号显示未格式化的XML文件
图7.在IE中显示的Doc.xml原始文件
6．要关闭Internet Explorer，先点击File，再点击Close。
7．在IDE中打开doc.xsl模板：点击File，再点击Add Existing Item。
8．打开路径C:\Documents and Settings\Administrator\My Documents\Visual Studio Projects\XMLComments
9．在Files of type中选择All Files，这将使doc.xsl文件名显示出来。
10．点击doc.xsl，接着按Open。doc.xsl就在IDE中打开，如图8。
图8 . IDE中的Doc.xsl
注意：doc.xsl文件的第二行有一个被注释掉的处理指令：，我们将在下一步骤里把它加到XML文件中。
11．将doc.xsl模板应用到doc.xml文件中：高亮选择doc.xsl模板第二行的XML处理命令，如图9。点击Edit,再点击Copy。
图9.doc.xsl中的类型表单处理指令
12．点击doc.xml标签。
13．在和标签之间插入一空行。
14．把光标放置在空行上，点击Edit，再点击Paste，屏幕上将显示图10界面。
图10. 加入类型表单处理指令后的Doc.xml文件
15．点击File，再点击Save doc.xml。
16．当你存完一个文件后，请注意在处理指令中的冒号不见了。然后需要在"xml"和"stylesheet"(不包括引号，就象图11中的第二行指令一样)之间加一个破折号(-)，让处理指令能正常工作。在插入一个破折号后，点击File，再点击Save doc.xml。
图11.具有正确类型表单格式的Doc.xml 打开doc.xml最终版本
你现在可以在浏览器中观看应用了类型表单的doc.xml。请确认在IDE中选定doc.xml标签。
1．点击View，再点击Open With。
2．点击Iexplore.exe，再点击Open。doc.xml 文件将以doc.xsl的格式显示在浏览器上。
图12. 在Internet Explorer应用了类型表单后的Doc.xml
结束
1．点击File，再点击Close关闭Internet Explorer。
2．点击File，再点击Exit关闭IDE。
|
