DiscoveryClientProtocol.DiscoverAny(String) Methode

Definition

Namespace:

System.Web.Services.Discovery

Assembly:

System.Web.Services.dll

Ermittelt die angegebene URL, um zu bestimmen, ob diese ein Discovery-Dokument, eine Dienstbeschreibung oder ein XSD-Schema (XML Schema Definition) darstellt.

C#

public System.Web.Services.Discovery.DiscoveryDocument DiscoverAny(string url);

Parameter

url

String

Die URL, bei der das XML Web Services Discovery-Tool beginnt.

Gibt zurück

DiscoveryDocument

Ein DiscoveryDocument, das die Ergebnisse der Ausführung des XML Web Services Discovery-Tools unter der angegebenen URL enthält. Wenn der url-Parameter auf eine Dienstbeschreibung oder ein XSD-Schema verweist, wird im Speicher ein entsprechendes DiscoveryDocument erstellt.

Ausnahmen

WebException

Beim Zugriff auf die angegebene URL wurde ein anderer HTTP-Statuscode als OK zurückgegeben.

InvalidOperationException

Der url-Parameter ist eine gültige URL. Sie zeigt jedoch nicht auf ein gültiges Discovery-Dokument, eine gültige Dienstbeschreibung oder ein gültiges XSD-Schema.

Beispiele

Das folgende Codebeispiel ist ein Webformular, das ein DataGrid mit den Details zu den Dokumenten in der Documents Eigenschaft zusammen mit den Verweisen füllt, die während einer XML-Webdienstermittlung in jedem Dokument gefunden wurden. Die PopulateGrid -Methode füllt die DataGrid mit den Ergebnissen eines DiscoverAny Aufrufs gefolgt von einem Aufruf von ResolveAllaus.

C#

 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>";
}

Hinweise

Die DiscoverAny Methode ermittelt, ob es sich bei der angegebenen URL um ein Ermittlungsdokument, eine Dienstbeschreibung oder um ein XSD-Schema handelt. Wenn bekannt ist, dass die URL nur auf ein Ermittlungsdokument verweist, wird die Discover Methode möglicherweise aufgerufen.

Wenn die angegebene URL auf ein gültiges Ermittlungsdokument, ein XSD-Schema oder eine Dienstbeschreibung verweist, wird das Ermittlungsdokument an der angegebenen URL der Documents Auflistung und References hinzugefügt. Wenn die angegebene URL auf ein XSD-Schema oder eine Dienstbeschreibung verweist, wird ein DiscoveryDocument im Arbeitsspeicher erstellt und der Documents Auflistung und References hinzugefügt. Darüber hinaus werden Verweise innerhalb des Ermittlungsdokuments der References Auflistung hinzugefügt, aber nicht überprüft, um auf gültige Ermittlungsdokumente zu verweisen. Um zu überprüfen, ob Verweise auf gültige Ermittlungsdokumente verweisen, rufen Sie die ResolveAll -Methode oder auf ResolveOneLevel .

Gilt für: