|
马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。
您需要 登录 才可以下载或查看,没有帐号?立即注册
x
竟发现没有太大的帮助。总觉得要用起来,感觉到不了位。因为公司机器的原因,一直没有安装vs.net(也从来没有用过)。以前做asp的时候一直用DW(感觉其代码联想功能不错),可现在到了asp.net却不习惯了。xml简介
年夜多半程序员大概都传闻过Java自带的一个工具JavaDoc;利用它能够主动地为你的代码天生HTML文档。C#和C#编译器也有相似的功效,不外它天生的是XML,而不是间接天生HTML。不外利用XML会使得文档加倍天真。
正文语法
为了利用C#供应的XML正文功效,你的正文应当利用特别的正文语法(///)开首。在///以后,你可使用事后界说的标签正文你的代码,也能够拔出你本人界说的标签。你定制的标签将会在随后到场到天生的正文文档中。
预界说的标签用途
<c>将申明中的文本标志为代码
<code>供应了一种将多行唆使为代码的办法
<example>指定利用办法或其他库成员的示例
<exception>同意你指定大概产生的非常类
<include>同意你援用形貌源代码中范例和成员的另外一文件中的正文,利用XMLXPath语法来形貌你的源代码中的范例和成员。
<list>向XML正文文档中拔出一个列表
<para>向XML正文文档中拔出一个段落
<param>形貌一个参数
<paramref>供应了一种唆使一个词为参数的办法
<permission>同意你将成员的会见允许到场到文档中
<remarks>用于增加有关某个范例的信息
<returns>形貌前往值
<see>指定链接
<seealso>指定但愿在“请拜见”一节中呈现的文本
<summary>范例或范例成员的通用形貌
<value>形貌属性
例子
上面的例子为我们罕见的HelloWorld把持台使用程序增加正文:
usingSystem;
namespaceHelloWorld
{
///<summary>
///SampleHelloWorldinC#
///</summary>
publicclassHelloWorld
{
///<summary>
///ConsoleApplicationEntryPoint
///<paramname="args">CommandLineArguments</param>
///<returns>Statuscodeof0onsuccessfulrun</returns>
///</summary>
publicstaticintMain(string[]args)
{
System.Console.WriteLine("HelloWorld");
stringname=System.Console.ReadLine();
return(0);
}
}
}
为天生XML正文文档,我们在挪用csc编译源代码时利用/doc选项:
csc/doc:HelloWorld.xmlhelloworld.cs
天生的了局文档以下:
<?xmlversion="1.0"?>
<doc>
<assembly>
<name>XMlComment</name>
</assembly>
<members>
<membername="T:HelloWorld.HelloWorld">
<summary>
SampleHelloWorldinC#
</summary>
</member>
<membername="M:HelloWorld.HelloWorld.Main(System.String[])">
<summary>
ConsoleApplicationEntryPoint
<paramname="args">CommandLineArguments</param>
<returns>Statuscodeof0onsuccessfulrun</returns>
</summary>
</member>
</members>
</doc>
HTML页面
你大概会问本人:我应当怎样才干失掉具有优秀格局的HTML页面呢?很复杂,你能够编写本人的XSL来转换天生的XML正文文档,大概利用VisualStudio.NET开辟工具。经由过程利用VS.NET的【工具】菜单中的【天生正文web页】,你能够失掉一系列具体申明你的项目或办理计划的HTML页面。上面就是经由过程VS.NET天生的正文helloWorld程序的HTML页面快照:
以前学了大概半年时间的asp(没有机会做大系统,最多是自己对公司系统做些调整和修改还有一些小程序)。应该说开始接触asp.net是今年元月5号的事。现在很想把公司的系统重新用.net来架构,却不知道如何下手。 |
|