DiscoveryClientProtocol.ReadAll メソッド

.NET Framework クラス ライブラリ リファレンス

DiscoveryClientProtocol.ReadAll メソッド

保存された探索ドキュメントのマップが格納されているファイルを読み取ります。その探索ドキュメントには、そのファイルが参照している探索ドキュメント、XML スキーマ定義 (XSD) スキーマ、およびサービスの説明を持つ Documents プロパティと References プロパティが読み込まれています。

名前空間: System.Web.Services.Discovery
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public Function ReadAll ( _
    topLevelFilename As String _
) As DiscoveryClientResultCollection

Visual Basic (使用法)

Dim instance As DiscoveryClientProtocol
Dim topLevelFilename As String
Dim returnValue As DiscoveryClientResultCollection

returnValue = instance.ReadAll(topLevelFilename)

C#

public DiscoveryClientResultCollection ReadAll (
    string topLevelFilename
)

C++

public:
DiscoveryClientResultCollection^ ReadAll (
    String^ topLevelFilename
)

J#

public DiscoveryClientResultCollection ReadAll (
    String topLevelFilename
)

JScript

public function ReadAll (
    topLevelFilename : String
) : DiscoveryClientResultCollection

パラメータ

topLevelFilename

読み込む対象となるファイルの名前。このファイルには保存されている探索ドキュメントのマップが格納されています。

戻り値
保存されている探索ドキュメントのマップを格納しているファイルで見つかった結果が格納されている DiscoveryClientResultCollection。ファイル形式は DiscoveryClientProtocol.DiscoveryClientResultsFile クラスで XML にシリアル化されています。ただし、通常は WriteAll メソッドまたは Disco.exe だけを使用してファイルを作成します。

解説

保存されている探索ドキュメントのマップを格納しているファイルは、WriteAll メソッドまたは Disco.exe により作成できます。

ファイルが現在のディレクトリにない場合は、topLevelFilename に絶対パスを含める必要があります。

使用例

ReadAll メソッドを使用して既存のディスカバリ マップ ドキュメント内に見つかったドキュメントと参照に関する詳細を DataGrid に読み込む Web フォームのコード例を次に示します。

Visual Basic

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

C#

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

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DiscoveryClientProtocol クラス
DiscoveryClientProtocol メンバ
System.Web.Services.Discovery 名前空間