System.Web.Services.Discovery.DiscoveryClientProtocol.Discover Method

Discovers the supplied URL to determine if it is a discovery document.

Syntax

public DiscoveryDocument Discover (string url)

Parameters

url
The URL where XML Web services discovery begins.

Returns

A System.Web.Services.Discovery.DiscoveryDocument containing the results of XML Web services discovery at the supplied URL.

Remarks

The DiscoveryClientProtocol.Discover(string) method expects that the supplied URL is a discovery document. If the URL refers to a service description or an XML schema an exception is thrown. To discover an XML schema or a service description invoke the DiscoveryClientProtocol.DiscoverAny(string) method.

If the supplied URL points to a valid discovery document, the discovery document at the supplied URL is added to the DiscoveryClientProtocol.Documents and DiscoveryClientProtocol.References collection. Additionally, references within the discovery document are added to the DiscoveryClientProtocol.References collection, but not verified to point to valid discovery documents. To verify the references, point to valid discovery documents to invoke the DiscoveryClientProtocol.ResolveAll or DiscoveryClientProtocol.ResolveOneLevel methods.

Requirements

Namespace: System.Web.Services.Discovery
Assembly: System.Web.Services (in System.Web.Services.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0