DiscoveryClientProtocol.DiscoverAny(String) Método

Definición

Espacio de nombres:

System.Web.Services.Discovery

Ensamblado:

System.Web.Services.dll

Detecta la dirección URL suministrada para determinar si se trata de un documento de descubrimiento, de una descripción de servicios o de un esquema XSD (lenguaje de definición de esquemas XML).

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

Parámetros

url

String

Dirección URL en la que se inicia el proceso de descubrimiento de servicios Web XML.

Devoluciones

DiscoveryDocument

DiscoveryDocument que contiene los resultados del proceso de descubrimiento de servicios Web XML en la dirección URL suministrada. Si el parámetro url hace referencia a una descripción de servicios o a un esquema XSD, se crea DiscoveryDocument en memoria para dicho parámetro.

Excepciones

WebException

El acceso a la dirección URL suministrada ha devuelto un código de estado HTTP distinto de OK.

InvalidOperationException

El parámetro url es una dirección URL válida, pero no señala a un documento de detección, descripción de servicios o esquema XSD válidos.

Ejemplos

El siguiente ejemplo de código es un formulario web que rellena con DataGrid los detalles sobre los documentos de la Documents propiedad junto con las referencias que se encuentran en cada documento durante una detección de servicios web XML. El PopulateGrid método rellena DataGrid con los resultados de una DiscoverAny invocación seguida de una llamada a 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

Comentarios

El DiscoverAny método detecta si la dirección URL proporcionada es un documento de detección, una descripción del servicio o un esquema XSD. Si se sabe que la dirección URL solo hace referencia a un documento de detección, se podría invocar el Discover método .

Si la dirección URL proporcionada apunta a un documento de detección válido, esquema XSD o descripción del servicio, el documento de detección en la dirección URL proporcionada se agrega a las Documents colecciones y References . Cuando la dirección URL proporcionada hace referencia a un esquema XSD o descripción del servicio, se crea en DiscoveryDocument memoria y se agrega a las Documents colecciones y References . Además, las referencias dentro del documento de detección se agregan a la References colección, pero no se comprueban para que apunten a documentos de detección válidos. Para comprobar que las referencias apuntan a documentos de detección válidos, invoque los ResolveAll métodos o ResolveOneLevel .