C#使用注释,XML文档说明,让发布的dll应用时具有方法属性说明

分类:.Net知识问答| 发布:camnprbubuol| 查看: | 发表时间:2011/1/4

C#编译器可以把XML元素从特定的注释中提取出来,并使用它们生成一个XML文件,要让编译器为程序集生成XML文档说明,需在编译时指定/doc选项,其后需跟上要被创建的文件的名称:

    csc /t:library /doc:Camnpr.xml Camnpr.cs

    如果XML注释没有生成格式正确的XML文档,编译器就抛出一个错误。

注意:

    编译器创建了一个<assembly>元素,并为该文件中的每个类或类成员添加一个<member>元素。每个<member>元素都有一个name特性,其中包含成员的全名,前面有一个字母表示其类型:

    “T:”--表示这是一个类型;

    “F:”--表示这是一个字段;

    “M:”--表示这是一个成员。

 

项目中引用这个生成的dll文件就行了,不需要生成的xml文档。

 

生成的时候要选择生成XML文档,然后其他项目引用的时候把Dll和XML文档一起拷贝到BIN文件夹就可以了!

 

要生成文件 Camnpr.DLL,请使用以下命令行编译文件 Add.cs 和文件 Mult.cs:
csc /target:library /out:Camnpr.DLL Add.cs Mult.cs
/target:library 编译器选项通知编译器输出 DLL 文件而不是 EXE 文件。后跟文件名的 /out 编译器选项用于指定 DLL 文件名。否则
,编译器使用第一个文件 (Add.cs) 作为 DLL 文件名。
若要生成可执行文件 TestCode.exe,请使用以下命令行:
csc /out:TestCode.exe /reference:MathLibrary.DLL TestCode.cs
/out 编译器选项通知编译器输出 EXE 文件并且指定输出文件名 (TestCode.exe)。此编译器选项是可选的。/引用编译器选项指定该程序
使用的 DLL 文件。
一组编译命令
设置path环境变量加上 ;C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727 保存
打开cmd
d:
cd D:\cSharpExercise\WebSite13\App_Code
csc /t:library /out:Samples.AspNet.CS.Controls.dll /r:System.dll /r:System.Web.dll *.cs
csc /res:WelcomeLabel.bmp,Samples.AspNet.CS.Controls.WelcomeLabel.bmp
/t:library /out:Samples.AspNet.CS.Controls.dll /r:System.dll
/r:System.Web.dll *.cs
工具箱-->右键--->选择项---->.Net Framework组件(右下角有个浏览)---->点浏览----->找到自定义的控件所在的dll,确定
<controls>
<add tagPrefix=&quot;aspSample1&quot;
namespace=&quot;Samples.AspNet.CS.Controls&quot;
assembly=&quot;Samples.AspNet.CS.Controls&quot;>
</add>
</controls>
<aspSample1:WelcomeLabel ID=&quot;WelcomeLabel3&quot; runat=&quot;server&quot; />
通常,.NET Framework 设计指导原则建议不要创建只包含很少的类的程序集。为了便于部署,应尽可能少地创建程序集。

365据说看到好文章不转的人,服务器容易宕机
原创文章如转载,请注明:转载自郑州网建-前端开发 http://camnpr.com/
本文链接:http://camnpr.com/net-wiki/162.html