DiscoveryClientProtocol.Discover(String) Metoda

Definice

Obor názvů:

System.Web.Services.Discovery

Sestavení:

System.Web.Services.dll

Zjistí zadanou adresu URL, která určí, jestli se jedná o dokument zjišťování.

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

Parametry

url

String

Začíná zjišťování webových služeb XML.

Návraty

DiscoveryDocument

Obsahuje DiscoveryDocument výsledky zjišťování webových služeb XML na zadané adrese URL.

Výjimky

WebException

Přístup k zadané adrese URL vrátil jiný stavový kód HTTP než OK.

InvalidOperationException

Parametr url je platná adresa URL, ale neodkazuje na platný dokument zjišťování.

Příklady

Následující příklad kódu je webový formulář, který naplní DataGrid podrobnostmi o dokumentech ve Documents vlastnosti spolu s odkazy nalezenými v každém dokumentu během zjišťování webových služeb XML. Metoda PopulateGrid vyplní DataGrid výsledky Discover vyvolání následované voláním 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

Poznámky

Metoda Discover očekává, že zadaná adresa URL je dokument zjišťování. Pokud adresa URL odkazuje na popis služby nebo schéma XML, vyvolá se výjimka. Pokud chcete zjistit schéma XML nebo popis služby, vyvoláte metodu DiscoverAny .

Pokud zadaná adresa URL odkazuje na platný dokument zjišťování, přidá se dokument zjišťování na zadané adrese URL do Documents kolekce a References kolekce. Kromě toho se do kolekce přidají References odkazy v dokumentu zjišťování, ale nejsou ověřeny tak, aby odkazovali na platné dokumenty zjišťování. Chcete-li ověřit odkazy, přejděte na platné dokumenty zjišťování pro vyvolání ResolveAll nebo ResolveOneLevel metod.