使用SandCastle创建.Net帮助文档
2014-07-20 14:56
633 查看
Sandcastle本身是一个console的程序,为了方便使用,我们可以使用他的GUI版本:
第一步,为你写的代码添加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来生成文档。
这是最终生成的文档:
相关文章推荐
- [转载]使用SandCastle创建.Net帮助文档
- 使用SandCastle创建.Net帮助文档
- 使用SandCastle创建.Net帮助文档
- 使用SandCastle创建.Net帮助文档
- 使用SandCastle创建.Net帮助文档
- 使用SandCastle创建.Net帮助文档
- 使用.NET中的XML注释(二) -- 创建帮助文档入门篇
- 使用Sandcastle工具为.NET项目工程生成一份项目帮助文档chm
- 使用.NET中的XML注释(二) -- 创建帮助文档入门篇
- 使用.NET中的XML注释(二) -- 创建帮助文档入门篇
- .net中使用Sandcastle(类似java中的jdoc)生成代码帮助文档
- 使用.NET中的XML注释(二) -- 创建帮助文档入门篇
- 使用Sandcastle生成.NET帮助文档
- 使用Sandcastle工具为.NET项目工程生成一份项目帮助文档chm
- [转]使用.NET中的XML注释(二) -- 创建帮助文档入门篇
- 使用.NET中的XML注释(二) -- 创建帮助文档入门篇
- 使用.NET中的XML注释(二) -- 创建帮助文档入门篇
- [转]Sandcastle创建帮助文档
- 创建专业级别的类库使用文档——Sandcastle十一月份CTP发布
- 在.NET 3.5 平台上使用LINQ to SQL创建三层/多层Web应用系统(源代码下载和PDF文档下载)