DiscoveryClientProtocol.Discover(String) Methode

public:
 System::Web::Services::Discovery::DiscoveryDocument ^ Discover(System::String ^ url);

public System.Web.Services.Discovery.DiscoveryDocument Discover(string url);

member this.Discover : string -> System.Web.Services.Discovery.DiscoveryDocument

Public Function Discover (url As String) As DiscoveryDocument

Parameters

Retouren

Een DiscoveryDocument met de resultaten van XML-webservicesdetectie op de opgegeven URL.

Uitzonderingen

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 de detectie van XML-webservices. De PopulateGrid methode vult de DataGrid resultaten van een Discover 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;
        
        // Only discover discovery documents, which might contain references to other types of discoverable documents.  
    doc = client.Discover(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
     ' Only discover discovery documents, which might contain references to other types of discoverable documents. 
     doc = client.Discover(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 our Grid 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 Discover methode verwacht dat de opgegeven URL een detectiedocument is. Als de URL verwijst naar een servicebeschrijving of een XML-schema, wordt er een uitzondering gegenereerd. Als u een XML-schema of een servicebeschrijving wilt detecteren, roept u de methode aan DiscoverAny .

Als de opgegeven URL verwijst naar een geldig detectiedocument, wordt het detectiedocument op de opgegeven URL toegevoegd aan de Documents en References verzameling. Daarnaast worden verwijzingen in het detectiedocument toegevoegd aan de References verzameling, maar niet geverifieerd om te verwijzen naar geldige detectiedocumenten. Als u de verwijzingen wilt controleren, wijst u geldige detectiedocumenten aan om de ResolveAll of ResolveOneLevel methoden aan te roepen.