您的位置:首页 > 其它

使用SandCastle创建.Net帮助文档

2014-07-20 14:56 633 查看



Sandcastle是微软提供的一个根据XML注释和DLL文件生成帮助文件的工具,目前是在CodePlex上的一个开源项目,可以去这里下载:Sandcatle项目

Sandcastle本身是一个console的程序,为了方便使用,我们可以使用他的GUI版本:SandcastleHelpFileBuilder

第一步,为你写的代码添加XML注释

我们创建一个简单的ClassLibrary1项目最为示范:

usingSystem;


usingSystem.Collections.Generic;


usingSystem.Text;




namespaceClassLibrary1


{


///<summary>


///AsampleclasstoshowsomethingusingSandcastle


///</summary>


publicclassSampleClass


{


privatestring_propertyValue;




///<summary>


///Getsorsetsthepropertyvalue.


///</summary>


///<value>Thepropertyvalue.</value>


publicstringProperty


{


get


{


return_propertyValue;


}


set


{


_propertyValue=value;


}


}




///<summary>


///Determineswhetherthepropertyisnull.


///</summary>


///<returns>


///<c>true</c>ifpropertyisnull;otherwise,<c>false</c>.


///</returns>


publicboolIsPropertyNull()


{


boolresult=false;




if(this.Property==null)


{


result=true;


}


returnresult;


}




///<summary>


///Determineswhetherthepropertyisnull.


///</summary>


///<returns>


///<c>true</c>ifpropertyisempty;otherwise,<c>false</c>.


///</returns>


///<example>


///Thisexampleshowshowyoumightusethismethod:


///


///<code>


///SampleClasssample=newSampleClass();


///


///if(sample.IsPropertyEmpty())


///{


///Console.WriteLine("Thepropertyisempty");


///}


///else


///{


///Console.WriteLine("Thepropertycontainsvalue"+sample.Property);


///}


///</code>


///</example>


publicboolIsPropertyEmpty()


{




boolresult=this.IsPropertyNull();




if(!result)


{


result=(Property.Trim().Length==0);


}


returnresult;


}


}


}


代码很简单,注意其中的XML注释。
打开项目的属性,在“Build”选项中,确保“XMLdocumentationfile:”被选中了。



第二步,编译这个项目,你会看到生成的DLL文件和XMl文件:




第三步,打开SandcastleHelpFileBuilder

打开SandcastleHelpFileBuilder并新建一个项目:



为SandcastleHelpFileBuilder项目添加编译生成的DLL文件,右键点击项目右边的“DocumentationSources",选择“AddDocumentationSource...”



选择刚刚生成的DLL文件。



第四步,修改设置

在项目的属性窗口,你可以根据需要修改一些设置。



第五步,生成文档




点击Buildthehelpfile来生成文档。
这是最终生成的文档:


内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: