DiscoveryClientProtocol.WriteAll メソッド

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

DiscoveryClientProtocol.WriteAll メソッド

Documents プロパティの探索ドキュメント、XML スキーマ定義 (XSD) スキーマ、およびサービスの説明のすべてを指定されたディレクトリに書き込み、そのディレクトリにファイルを作成します。

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

Visual Basic (宣言)

Public Function WriteAll ( _
    directory As String, _
    topLevelFilename As String _
) As DiscoveryClientResultCollection

Visual Basic (使用法)

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

returnValue = instance.WriteAll(directory, topLevelFilename)

C#

public DiscoveryClientResultCollection WriteAll (
    string directory,
    string topLevelFilename
)

C++

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

J#

public DiscoveryClientResultCollection WriteAll (
    String directory, 
    String topLevelFilename
)

JScript

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

パラメータ

directory

現在 Documents プロパティにあるすべてのドキュメントの保存先ディレクトリ。

topLevelFilename

保存されているすべてのドキュメントのマップを格納している、作成または上書きするファイルの名前。

戻り値
保存されているすべてのファイルの結果を格納している DiscoveryClientResultCollection。

解説

ファイルは、ディレクトリ パラメータによって指定されたディレクトリ内の topLevelFilename パラメータの名前で作成され、保存されている探索ドキュメント、XML スキーマ定義 (XSD) スキーマ、およびサービスの説明のマップが格納されています。ファイルを読み取るには、ReadAll メソッドを使用して References プロパティと Documents プロパティを設定します。ファイルの形式は DiscoveryClientProtocol.DiscoveryClientResultsFile クラスのシリアル化バージョンが格納されている XML です。

directory パラメータ内に topLevelFilename パラメータと同じ名前のファイルが存在する場合、このファイルは WriteAll メソッドにより上書きされます。ファイルが現在のディレクトリにない場合は、topLevelFilename に絶対パスを含める必要があります。

使用例

DiscoverAny と ResolveAll を呼び出した後に WriteAll メソッドを呼び出して Web サービス探索の結果をディスクに書き込む Web フォームのコード例を次に示します。

Visual Basic

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

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

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

プラットフォーム

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 名前空間
ReadAll
DiscoveryClientProtocol.DiscoveryClientResultsFile