DiscoveryClientProtocol.DiscoverAny(String) Méthode

Référence

Définition

Espace de noms:: System.Web.Services.Discovery

Assembly:: System.Web.Services.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Détecte l'URL fournie afin de déterminer si c'est un document de découverte, une description de service ou un schéma XSD (XML Schema Definition).

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

Paramètres

url: String

URL où commence la découverte de services Web XML.

Retours

DiscoveryDocument

DiscoveryDocument contenant les résultats de la découverte de services Web XML à l'URL fournie. Si le paramètre url fait référence à une description de service ou à un schéma XSD, un DiscoveryDocument est créé pour lui en mémoire.

Exceptions

WebException

L'accès à l'URL fournie a retourné un code d'état HTTP autre que OK.

InvalidOperationException

Le paramètre url est une URL valide, mais il ne pointe pas vers un document de découverte valide, une description de service ou un schéma XSD.

Exemples

L’exemple de code suivant est un formulaire web qui remplit un DataGrid avec les détails des documents dans la Documents propriété ainsi que les références trouvées dans chaque document lors d’une découverte de services Web XML. La PopulateGrid méthode remplit le DataGrid avec les résultats d’un DiscoverAny appel suivi d’un appel à 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

Remarques

La DiscoverAny méthode découvre si l’URL fournie est un document de découverte, une description de service ou un schéma XSD. S’il est connu que l’URL fait uniquement référence à un document de découverte, la Discover méthode peut être appelée.

Si l’URL fournie pointe vers un document de découverte valide, un schéma XSD ou une description de service, le document de découverte à l’URL fournie est ajouté aux Documents collections et References . Lorsque l’URL fournie fait référence à un schéma XSD ou à une description de service, un DiscoveryDocument est créé en mémoire et ajouté aux Documents collections et References . En outre, les références dans le document de découverte sont ajoutées à la References collection, mais pas vérifiées pour pointer vers des documents de découverte valides. Pour vérifier que les références pointent vers des documents de découverte valides, appelez les ResolveAll méthodes ou ResolveOneLevel .

S’applique à