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

Parameter

Gibt zurück

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

Ausnahmen

Beispiele

Das folgende Codebeispiel ist ein Webformular, das ein DataGrid Webformular mit den Details zu den Dokumenten in der Documents Eigenschaft zusammen mit den Verweisen auf jedes Dokument während der XML-Webdienstermittlung auffüllt. Die PopulateGrid Methode füllt die DataGrid Ergebnisse aus einem Discover Aufruf gefolgt von einem Aufruf von 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

Hinweise

Die Discover Methode erwartet, dass die angegebene URL ein Ermittlungsdokument ist. Wenn die URL auf eine Dienstbeschreibung oder ein XML-Schema verweist, wird eine Ausnahme ausgelöst. Rufen Sie die DiscoverAny Methode auf, um ein XML-Schema oder eine Dienstbeschreibung zu ermitteln.

Wenn die angegebene URL auf ein gültiges Discoverydokument verweist, wird das Ermittlungsdokument an der angegebenen URL der Documents Auflistung References hinzugefügt. Darüber hinaus werden Verweise innerhalb des Ermittlungsdokuments der References Auflistung hinzugefügt, aber nicht überprüft, um auf gültige Ermittlungsdokumente zu verweisen. Um die Verweise zu überprüfen, zeigen Sie auf gültige Ermittlungsdokumente, um die ResolveAll Methoden aufzurufen ResolveOneLevel .