DiscoveryClientProtocol.DiscoverAny(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de opgegeven URL gedetecteerd om te bepalen of het een detectiedocument, servicebeschrijving of een XSD-schema (XML Schema Definition) is.
public:
System::Web::Services::Discovery::DiscoveryDocument ^ DiscoverAny(System::String ^ url);
public System.Web.Services.Discovery.DiscoveryDocument DiscoverAny(string url);
member this.DiscoverAny : string -> System.Web.Services.Discovery.DiscoveryDocument
Public Function DiscoverAny (url As String) As DiscoveryDocument
Parameters
- url
- String
De URL waar de detectie van XML-webservices begint.
Retouren
Een DiscoveryDocument met de resultaten van XML-webservicesdetectie op de opgegeven URL. Als de url parameter verwijst naar een servicebeschrijving of een XSD-schema, wordt er een DiscoveryDocument in het geheugen gemaakt.
Uitzonderingen
Als u de opgegeven URL opent, is een andere HTTP-statuscode dan OK.
De url parameter is een geldige URL, maar verwijst niet naar een geldig detectiedocument, servicebeschrijving of XSD-schema.
Voorbeelden
Het volgende codevoorbeeld is een webformulier dat een DataGrid met de details over de documenten in de Documents eigenschap vult, samen met de verwijzingen in elk document tijdens een DETECTIE van XML-webservices. De PopulateGrid methode vult de DataGrid resultaten van een DiscoverAny aanroep in, gevolgd door een aanroep naar ResolveAll.
protected void Discover_Click(object Source, EventArgs e)
{
// Specify the URL to discover.
string sourceUrl = DiscoURL.Text;
// Specify the URL to save discovery results to or read from.
string outputDirectory = DiscoDir.Text;
DiscoveryClientProtocol client = new DiscoveryClientProtocol();
// Use default credentials to access the URL being discovered.
client.Credentials = CredentialCache.DefaultCredentials;
try
{
DiscoveryDocument doc;
// Discover the URL for any discoverable documents.
doc = client.DiscoverAny(sourceUrl);
// Resolve all possible references from the supplied URL.
client.ResolveAll();
}
catch ( Exception e2)
{
DiscoveryResultsGrid.Columns.Clear();
Status.Text = e2.Message;
}
// If documents were discovered, display the results in a data grid.
if (client.Documents.Count > 0)
PopulateGrid(client);
// Save the discovery results to disk.
DiscoveryClientResultCollection results = client.WriteAll(outputDirectory, "results.discomap");
Status.Text = "The following file holds the links to each of the discovery results: <b>" +
Path.Combine(outputDirectory,"results.discomap") + "</b>";
}
Public Sub Discover_Click(Source As Object, e as EventArgs )
' Specify the URL to discover.
Dim sourceUrl as String = DiscoURL.Text
' Specify the URL to save discovery results to or read from.
Dim outputDirectory As String = DiscoDir.Text
Dim client as DiscoveryClientProtocol = new DiscoveryClientProtocol()
' Use default credentials to access the URL being discovered.
client.Credentials = CredentialCache.DefaultCredentials
Try
Dim doc As DiscoveryDocument
' Discover the URL for any discoverable documents.
doc = client.DiscoverAny(sourceUrl)
' Resolve all possible references from the supplied URL.
client.ResolveAll()
Catch e2 As Exception
DiscoveryResultsGrid.Columns.Clear()
Status.Text = e2.Message
End Try
' If documents were discovered, display the results in a data grid.
If (client.Documents.Count > 0) Then
'populate the DataGrid with the discovery results.
PopulateGrid(client)
End If
' Save the discovery results to disk
Dim results As DiscoveryClientResultCollection
results = client.WriteAll(outputDirectory, "results.discomap")
Status.Text = "The following file holds the links to each of the discovery results: <b>" + _
Path.Combine(outputDirectory,"results.discomap") + "</b>"
End Sub
Opmerkingen
De DiscoverAny methode detecteert of de opgegeven URL een detectiedocument, servicebeschrijving of XSD-schema is. Als het bekend is dat de URL alleen verwijst naar een detectiedocument, kan de Discover methode worden aangeroepen.
Als de opgegeven URL verwijst naar een geldig detectiedocument, XSD-schema of servicebeschrijving, wordt het detectiedocument op de opgegeven URL toegevoegd aan de Documents en References verzamelingen. Wanneer de opgegeven URL verwijst naar een XSD-schema of servicebeschrijving, wordt er een DiscoveryDocument in het geheugen gemaakt en toegevoegd aan de Documents en References verzamelingen. Daarnaast worden verwijzingen in het detectiedocument toegevoegd aan de References verzameling, maar niet geverifieerd om te verwijzen naar geldige detectiedocumenten. Als u wilt controleren of verwijzingen verwijzen naar geldige detectiedocumenten, roept u de ResolveAll of ResolveOneLevel methoden aan.