XML Web Services Publishing and Deployment

This topic is specific to a legacy technology. XML Web services and XML Web service clients should now be created using Windows Communication Foundation.

Deploying a Web service involves copying the .asmx file and any assemblies used by the Web service not shipping as a part of the.NET Framework into a virtual directory on a Web server. For more information about how to deploy a Web service, see Deploying XML Web Services.

Web Service Discovery

Web service discovery is the process of locating and interrogating Web service descriptions, which is a preparatory step for accessing a Web service. Through the discovery process, Web service clients can learn at design time that a Web service exists, what its capabilities are, and how to properly interact with it.

Web services are made available to users using a discovery mechanism that usually takes the form of a discovery document, an XML document that can contains links to other discovery documents, XSD schemas, and service descriptions in the Web Services Description Language (WSDL). From these documents they can determine what services are available to them.

There are three ways a potential Web service client can access a discovery document:

  • Static discovery file: Publish a discovery file, typically with a .disco file name extension. Users can browse to a specific discovery file or to the root of the Web application if the default Web page has a link to the file. A .disco file can contain references to any number of Web services.

  • ?disco query string: Any Web service that runs on ASP.NET can have a discovery document dynamically generated for it. A discovery document is automatically generated for a Web service when it is accessed using a URL with ?DISCO provided in the query string. For instance, if the URL to a Web service is www.contoso.com/getquote.asmx, then a discovery document is automatically generated with a URL of www.contoso.com/getquote.asmx?DISCO. The discovery document applies only to that Web service.

  • .vsdisco request: You can turn on dynamic discovery to allow Web service client applications to discover all available Web services in the folder and subfolders that correspond to a request URL. No static discovery document needs to be composed. When dynamic discovery is turned on for a Web server, a Visual Studio .NET developer that wants to generate a client proxy can specify a URL referencing a file with a .vsdisco extension, such as www.contoso.com/default.vsdisco, in the Add Web Reference dialog box.

For more information about enabling static discovery files and .vsdisco requests for your Web services, see How to: Enable Discovery for XML Web Services.

See Also


How to: Enable Discovery for XML Web Services
How to: Disable Protocol Support for Web Services


Deploying XML Web Services
Configuration Options for XML Web Services Created Using ASP.NET

Other Resources

XML Web Services Using ASP.NET