DiscoveryClientProtocol.DiscoverAny(String) Metoda

Definicja

Przestrzeń nazw:

System.Web.Services.Discovery

Zestaw:

System.Web.Services.dll

Odnajduje podany adres URL w celu określenia, czy jest to dokument odnajdywania, opis usługi lub schemat definicji schematu XML (XSD).

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

Parametry

url

String

Adres URL, pod którym rozpoczyna się odnajdywanie usług sieci Web XML.

Zwraca

DiscoveryDocument

Element DiscoveryDocument zawierający wyniki odnajdywania usług sieci Web XML pod podanym adresem URL. url Jeśli parametr odwołuje się do opisu usługi lub schematu XSD, DiscoveryDocument zostanie on utworzony w pamięci.

Wyjątki

WebException

Uzyskanie dostępu do podanego adresu URL zwróciło kod stanu HTTP inny niż OK.

InvalidOperationException

Parametr url jest prawidłowym adresem URL, ale nie wskazuje prawidłowego dokumentu odnajdywania, opisu usługi ani schematu XSD.

Przykłady

Poniższy przykład kodu to formularz internetowy, który wypełnia DataGrid obiekt ze szczegółami dotyczącymi dokumentów we Documents właściwości wraz z odwołaniami znajdującymi się w każdym dokumencie podczas odnajdywania usług sieci Web XML. Metoda PopulateGrid wypełnia metodę DataGrid wynikami wywołania DiscoverAny , po którym następuje wywołanie metody 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

Uwagi

Metoda DiscoverAny wykrywa, czy podany adres URL jest dokumentem odnajdywania, opisem usługi czy schematem XSD. Jeśli wiadomo, że adres URL odwołuje się tylko do dokumentu odnajdywania, Discover metoda może zostać wywołana.

Jeśli podany adres URL wskazuje prawidłowy dokument odnajdywania, schemat XSD lub opis usługi, dokument odnajdywania pod podanym adresem URL zostanie dodany do Documents kolekcji i References . Gdy podany adres URL odwołuje się do schematu XSD lub opisu usługi, DiscoveryDocument jest tworzony w pamięci i dodawany do Documents kolekcji i References . Ponadto odwołania w dokumencie odnajdywania są dodawane do References kolekcji, ale nie są weryfikowane w celu wskazania prawidłowych dokumentów odnajdywania. Aby sprawdzić, czy odwołania wskazują prawidłowe dokumenty odnajdywania, wywołaj ResolveAll metody lub ResolveOneLevel .