DiscoveryClientProtocol.WriteAll-Methode

Schreibt alle Discovery-Dokumente, XSD-Schemas (XML Schema Definition) und Dienstbeschreibungen in der Documents-Eigenschaft in das angegebene Verzeichnis und erstellt eine Datei in diesem Verzeichnis.

Namespace: System.Web.Services.Discovery
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Function WriteAll ( _
    directory As String, _
    topLevelFilename As String _
) As DiscoveryClientResultCollection
'Usage
Dim instance As DiscoveryClientProtocol
Dim directory As String
Dim topLevelFilename As String
Dim returnValue As DiscoveryClientResultCollection

returnValue = instance.WriteAll(directory, topLevelFilename)

public DiscoveryClientResultCollection WriteAll (
    string directory,
    string topLevelFilename
)

public:
DiscoveryClientResultCollection^ WriteAll (
    String^ directory, 
    String^ topLevelFilename
)

public DiscoveryClientResultCollection WriteAll (
    String directory, 
    String topLevelFilename
)

public function WriteAll (
    directory : String, 
    topLevelFilename : String
) : DiscoveryClientResultCollection

Parameter

• directory
  Das Verzeichnis, in dem alle gegenwärtig in der Documents-Eigenschaft enthaltenen Dokumente gespeichert werden sollen.

• topLevelFilename
  Der Name der zu erstellenden oder zu überschreibenden Datei mit einer Zuordnung aller gespeicherten Dokumente.

Rückgabewert

Eine DiscoveryClientResultCollection mit den Ergebnissen aller gespeicherten Dateien.

Hinweise

Die Datei, die mit dem Namen des topLevelFilename-Parameters im vom Verzeichnisparameter angegebenen Verzeichnis erstellt wurde, enthält eine Zuordnung gespeicherter Discovery-Dokumente, XSD-Schemas (XML Schema Definition) und Dienstbeschreibungen. Diese Datei kann mit der ReadAll-Methode eingelesen werden, um die References-Eigenschaft und die Documents-Eigenschaft zu füllen. Das Format der Datei ist XML mit einer serialisierten Version der DiscoveryClientProtocol.DiscoveryClientResultsFile-Klasse.

Wenn eine Datei mit demselben Namen wie der topLevelFilename-Parameter im directory-Parameter vorhanden ist, wird diese Datei durch die WriteAll-Methode überschrieben. Der topLevelFilename-Parameter muss den vollqualifizierten Pfad enthalten, wenn die Datei nicht im aktuellen Verzeichnis vorhanden ist.

Beispiel

Das folgende Codebeispiel veranschaulicht ein Web Form, das die Ergebnisse einer Webdienstdiscovery auf einen Datenträger schreibt, indem nach einem Aufruf von DiscoverAny und von ResolveAll die WriteAll-Methode aufgerufen wird.

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

    ' 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

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DiscoveryClientProtocol-Klasse
DiscoveryClientProtocol-Member
System.Web.Services.Discovery-Namespace
ReadAll
DiscoveryClientProtocol.DiscoveryClientResultsFile