ASP.NET in a Nutshell

Name

DiscoveryClientProtocol

Synopsis

Most types in this namespace are used for modelling discovery documents. This class provides the utility methods that allow you to reflect on URLs and create the appropriate discovery document objects. This class is based on two properties: Documents, which contains a collection of discovery documents, and the References, which will contain a collection of disovery document references when the discovery process is complete.

To start the discovery process, you need to know the location of the discovery document you want to process (which could have been retrieved through a service like UDDI). You can then use the Discover() method and supply the appropriate URL as a string. (Alternatively, you can use the DiscoverAny() method if you are not sure whether the URL points to a discovery document, WSDL service description, or XSD file). If the document is valid, the document will be added to the References and Documents collection. In addition, all references contained in the discovery document are added to the References collection, but they are not validated.

To verify the discovery document’s references (the next stage of the discovery process), you should use the ResolveOneLevel() method, which moves through the References collection and ensures that all valid references are added to the Documents collection. Alternatively, you can use the ResolveAll() method, which will examine any nested discovery documents. For example, if you have a discovery ...