Aracılığıyla paylaş


DiscoveryClientProtocol.DiscoverAny(String) Yöntem

Tanım

Bir bulma belgesi, hizmet açıklaması veya XML Şema Tanımı (XSD) şeması olup olmadığını belirlemek için sağlanan URL'yi bulur.

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

Parametreler

url
String

XML Web hizmetleri bulma işleminin başladığı URL.

Döndürülenler

DiscoveryDocument Sağlanan URL'de XML Web hizmetleri bulma sonuçlarını içeren. url Parametre bir hizmet açıklamasına veya XSD Şemasına başvuruyorsa, bunun için bellekte bir DiscoveryDocument oluşturulur.

Özel durumlar

Sağlanan URL'ye erişmek dışında OKbir HTTP durum kodu döndürdü.

url parametresi geçerli bir URL'dir, ancak geçerli bir bulma belgesine, hizmet açıklamasına veya XSD şemasına işaret etmez.

Örnekler

Aşağıdaki kod örneği, bir XML Web hizmetleri bulma sırasında her belgede bulunan başvurularla birlikte özelliğindeki Documents belgelerle ilgili ayrıntılarla dolduran DataGrid bir Web Formudur. yöntemi, PopulateGrid çağrısının ardından çağrısının DiscoverAnyResolveAllsonuçlarıyla doldururDataGrid.

 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

Açıklamalar

yöntemi, DiscoverAny sağlanan URL'nin bulma belgesi mi, hizmet açıklaması mı yoksa XSD şeması mı olduğunu bulur. URL'nin yalnızca bulma belgesine başvurduğu biliniyorsa yöntemi Discover çağrılabilir.

Sağlanan URL geçerli bir bulma belgesine, XSD şemasına veya hizmet açıklamasına işaret ederse, sağlanan URL'deki bulma belgesi ve References koleksiyonlarına Documents eklenir. Sağlanan URL bir XSD şemasına veya Hizmet Açıklamasına başvurduğunda bellekte bir DiscoveryDocument oluşturulur ve ve References koleksiyonlarına Documents eklenir. Ayrıca, bulma belgesi içindeki başvurular koleksiyona References eklenir, ancak geçerli bulma belgelerine işaret etmek için doğrulanmaz. Başvuruların geçerli bulma belgelerine işaret ettiğini doğrulamak için veya ResolveOneLevel yöntemlerini çağırınResolveAll.

Şunlara uygulanır