Problem using SandCastle with ASP.NET 2.0 WebSite
Hello,
I have all the pre-compiled dlls of the asp.net 2.0 application, I trying to use Eric Woodruff's sandcastle GUI While building the build fails asking for System.Configuration
unresolved assembly reference: System.Configuration (System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a) required by App_WebReferences
BUILD FAILED: Unexpected error in last build step. See output above for details.
Does it necessary that i should include all the namepaces used to build documentation for a project.
Can anyone point me who to use sandcastle with asp.net web applications.
thanks!!
sqlnew
[681 byte] By [
SQLNew] at [2007-12-24]
Hello Eric,
thank you for the information you have provided. After adding the dependencies I get the following error which says that the error occured in intializing BuildComponent.dll . could you please give me an insight why this is happening.
Error: BuildComponent: An error occured while initializing the type 'Microsoft.Ddue.Tools.CopyFromIndexComponent' in the component assembly 'C:\Program Files\Sandcastle\ProductionTools\BuildComponents\BuildComponents.dll'. The error message and stack trace follows: System.Xml.XmlException: Root element is missing.
at System.Xml.XmlTextReaderImpl.Throw(Exception e)
at System.Xml.XmlTextReaderImpl.ThrowWithoutLineInfo(String res)
at System.Xml.XmlTextReaderImpl.ParseDocumentContent()
at System.Xml.XmlTextReaderImpl.Read()
at System.Xml.XPath.XPathDocument.LoadFromReader(XmlReader reader, XmlSpace space)
at System.Xml.XPath.XPathDocument..ctor(String uri, XmlSpace space)
at System.Xml.XPath.XPathDocument..ctor(String uri)
at Microsoft.Ddue.Tools.IndexedDocument..ctor(String file, XPathExpression valueExpression, XPathExpression keyExpression)
at Microsoft.Ddue.Tools.IndexedDocumentCache.AddDocument(String file)
at Microsoft.Ddue.Tools.IndexedDocumentCache.AddDocuments(String wildcardPath)
at Microsoft.Ddue.Tools.CopyFromIndexComponent..ctor(XPathNavigator configuration)
Thanks!!
SqlNew
hello Eric,
I tried to over come this problem by adding a <doc /> tag to my xml file . Now the help file gets generated without the ///<summary> or any other information..
please let me know what could be causing this,
thanks!
SqlNew
I'm not sure which file you are refering to when you say you added a "<doc/>" tag. If it's the XML comments file for the assembly, that should be getting generated by the C# or VB.NET compiler when you build the project with Visual Studio. Its possible there's something different about this as it is a web application.
Eric
Hello
I found out that I was not building XML comments file for the website. Only for class libraries there is an option to build the comments file. But for website I did not find any option to build XML file.
Can anyone point me how to build xml comments file for and asp.net web application.
Thanks!!
SqlNew
