Friday, September 30, 2005

Custom ASP.NET Web Service Descriptions

I'm working on the Web Service API for a product at work and needed a way to override the default ASMX generated help page. I found this document on CodeProject:

To use the new documentation generator in your code, do the following:

  • Add the files ServiceDescriptionGenerator.aspx and WebServiceDocumentation.css to your project.
  • Change your application's web.config to reference the new service description generator, as described above and shown in the sample project.
  • Create a new XML file containing your documentation. The file should be named like your WebService.asmx file, but with a suffix of Documentation.aspx, for example: WebServiceDocumentation.aspx.
[Code Project]

Very Nice!