Compartilhar via


DiscoveryClientProtocol.Discover(String) Método

Definição

Descobre a URL fornecida para determinar se é um documento de descoberta.

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

Parâmetros

url
String

A URL em que começa a descoberta de Serviços Web XML.

Retornos

DiscoveryDocument

Um DiscoveryDocument contendo os resultados da descoberta de Serviços Web XML na URL fornecida.

Exceções

Acessar a URL fornecida retornou um código de status HTTP diferente de OK.

O parâmetro url é uma URL válida, mas não aponta para um documento de descoberta válido.

Exemplos

O exemplo de código a Documents seguir é um Formulário Web que preenche um DataGrid com os detalhes sobre os documentos na propriedade junto com as referências encontradas em cada documento durante a descoberta de serviços Web XML. O PopulateGrid método preenche os DataGrid resultados de uma Discover invocação seguida de uma chamada para 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

Comentários

O Discover método espera que a URL fornecida seja um documento de descoberta. Se a URL se referir a uma descrição de serviço ou a um esquema XML, uma exceção será gerada. Para descobrir um esquema XML ou uma descrição de serviço, invoque o DiscoverAny método.

Se a URL fornecida apontar para um documento de descoberta válido, o documento de descoberta na URL fornecida será adicionado à coleção e References à Documents coleção. Além disso, as referências dentro do documento de descoberta são adicionadas à References coleção, mas não verificadas para apontar para documentos de descoberta válidos. Para verificar as referências, aponte para documentos de descoberta válidos para invocar os métodos ou ResolveOneLevel os ResolveAll métodos.

Aplica-se a