This documentation is archived and is not being maintained.

DiscoveryClientProtocol::Discover Method

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

Namespace:  System.Web.Services.Discovery
Assembly:  System.Web.Services (in System.Web.Services.dll)

[PermissionSetAttribute(SecurityAction::LinkDemand, Name = L"FullTrust")]
public:
DiscoveryDocument^ Discover(
	String^ url
)

Parameters

url
Type: System::String

The URL where XML Web services discovery begins.

Return Value

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

ExceptionCondition
WebException

Accessing the supplied URL returned an HTTP status code other than OK.

InvalidOperationException

The url parameteris a valid URL, but does not point to a valid discovery document.

The Discover 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 DiscoverAny method.

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

The following code example is a Web Form that populates a DataGrid with the details about the documents in the Documents property together with the references found in each document during XML Web services discovery. The PopulateGrid method fills the DataGrid with the results from a Discover invocation followed by a call to ResolveAll.

No code example is currently available or this language may not be supported.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Show: