DiscoveryClientProtocol.Discover(String) Méthode

Définition

Espace de noms:

System.Web.Services.Discovery

Assembly:

System.Web.Services.dll

Découvre l’URL fournie pour déterminer s’il s’agit d’un document de découverte.

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

Paramètres

url

String

URL de début de la découverte des services Web XML.

Retours

DiscoveryDocument

Contenant DiscoveryDocument les résultats de la découverte de services Web XML à l’URL fournie.

Exceptions

WebException

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

InvalidOperationException

Le url paramètre est une URL valide, mais ne pointe pas vers un document de découverte valide.

Exemples

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

Remarques

La Discover méthode s’attend à ce que l’URL fournie soit un document de découverte. Si l’URL fait référence à une description de service ou à un schéma XML, une exception est levée. Pour découvrir un schéma XML ou une description de service, appelez la DiscoverAny méthode.

Si l’URL fournie pointe vers un document de découverte valide, le document de découverte à l’URL fournie est ajouté à la collection et References à la Documents collection. En outre, les références dans le document de découverte sont ajoutées à la References collection, mais elles ne sont pas vérifiées pour pointer vers des documents de découverte valides. Pour vérifier les références, pointez sur des documents de découverte valides pour appeler le ou ResolveOneLevel les ResolveAll méthodes.