DiscoveryClientProtocol.ReadAll-Methode

Liest eine Datei ein, die eine Zuordnung gespeicherter Discovery-Dokumente enthält, die die Documents-Eigenschaft und die References-Eigenschaft füllen, wobei in der Datei auf Discovery-Dokumente, XSD-Schemas (XML Schema Definition) und Dienstbeschreibungen verwiesen wird.

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

Syntax

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

returnValue = instance.ReadAll(topLevelFilename)

public DiscoveryClientResultCollection ReadAll (
    string topLevelFilename
)

public:
DiscoveryClientResultCollection^ ReadAll (
    String^ topLevelFilename
)

public DiscoveryClientResultCollection ReadAll (
    String topLevelFilename
)

public function ReadAll (
    topLevelFilename : String
) : DiscoveryClientResultCollection

Parameter

• topLevelFilename
  Name einer einzulesenden Datei, die die Zuordnung gespeicherter Discovery-Dokumente enthält.

Rückgabewert

Eine DiscoveryClientResultCollection, die die Ergebnisse enthält, die in der Datei mit der Zuordnung gespeicherter Discovery-Dokumente gefunden wurden. Das Dateiformat ist eine DiscoveryClientProtocol.DiscoveryClientResultsFile-Klasse, die in XML serialisiert wurde. In der Regel wird die Datei jedoch nur mit der WriteAll-Methode oder mit Disco.exe erstellt.

Hinweise

Eine Datei mit einer Zuordnung gespeicherter Discovery-Dokumente kann mit der WriteAll-Methode oder mit Disco.exe erstellt werden.

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 ein DataGrid mit den Einzelheiten über die Dokumente und Verweise füllt, die unter Verwendung der ReadAll-Methode in einem vorhandenen Discoveryzuordnungsdokument gefunden wurden.

Public Sub Discover_Click(Source As Object, e as EventArgs )
   ' Specify the URL to read the discovery results from.
   Dim outputDirectory As String = DiscoDir.Text

   Dim client as DiscoveryClientProtocol = new DiscoveryClientProtocol()
   ' Use default credentials to access files containing the previously saved discovery results.
   client.Credentials = CredentialCache.DefaultCredentials
   Try 
        Dim doc As DiscoveryDocument
  
    ' Read in existing discovery results.
     Dim results As DiscoveryClientResultCollection 
     results = client.ReadAll(Path.Combine(DiscoDir.Text,"results.discomap"))

   Catch e2 As Exception
          DiscoveryResultsGrid.Columns.Clear()
       Status.Text = e2.Message
   End Try

   ' If disocvery documents existed in the supplied folder, display the results in a data grid.
    If (client.Documents.Count > 0) Then
         ' Populate the data grid with the discovery results.
     PopulateGrid(client)
    End If
End Sub

 protected void Discover_Click(object Source, EventArgs e)
 {
  // Specify the URL to read the discovery results from.
  string outputDirectory = DiscoDir.Text;

      DiscoveryClientProtocol client = new DiscoveryClientProtocol();
  // Use default credentials to access the files containing the discovery results.
      client.Credentials = CredentialCache.DefaultCredentials;

      try {
           DiscoveryDocument doc;
    // Read in existing discovery results.
        DiscoveryClientResultCollection results = client.ReadAll(Path.Combine(DiscoDir.Text,"results.discomap"));
      }
      catch ( Exception e2) 
      {
        DiscoveryResultsGrid.Columns.Clear();
        Status.Text = e2.Message;
      }
  // If discovery documents existed in the supplied folder, display the results in a data grid.
      if (client.Documents.Count > 0)
      PopulateGrid(client);
}

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