SslStream.EndWrite メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SslStream.EndWrite メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

BeginWrite の以前の呼び出しで開始した非同期書き込み操作を終了します。

名前空間: System.Net.Security
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub EndWrite
 ( _
    asyncResult As IAsyncResult _
)

Visual Basic (使用法)

Dim instance As SslStream
Dim asyncResult As IAsyncResult

instance.EndWrite(asyncResult)

public override void EndWrite (
    IAsyncResult asyncResult
)

C++

public:
virtual void EndWrite (
    IAsyncResult^ asyncResult
) override

public void EndWrite (
    IAsyncResult asyncResult
)

JScript

public override function EndWrite (
    asyncResult : IAsyncResult
)

パラメータ

asyncResult: BeginWrite の呼び出しによって返される IAsyncResult インスタンス。

例外

例外の種類	条件
ArgumentNullException	asyncResult が null 参照 (Visual Basic では Nothing) です。
ArgumentException	BeginWrite への呼び出しで asyncResult が作成されませんでした。
InvalidOperationException	完了する保留中の書き込み操作がありません。
IOException	書き込み操作に失敗しました。
InvalidOperationException	認証が行われていません。

解説

操作が完了していない場合、このメソッドは操作が完了するまでブロックします。

このメソッドは、正常に認証されるまで呼び出すことはできません。認証するには、AuthenticateAsClient、BeginAuthenticateAsClient、AuthenticateAsServer、BeginAuthenticateAsServer のいずれかのメソッドを呼び出します。

この操作を同期で実行するには、Write メソッドを使用します。

使用例

非同期書き込み操作を終了するコード例を次に示します。

void WriteCallback(IAsyncResult ar)
{
    ClientState state = (ClientState) ar.AsyncState;
    SslStream stream = state.stream;
    try 
    {
        Console.WriteLine("Writing data to the client.");
        stream.EndWrite(ar);
    }
    catch (Exception writeException)
    {
        Console.WriteLine("Write error: {0}", 
            writeException.Message);
        state.Close();
        return;
    }
    Console.WriteLine("Finished with client.");
    state.Close();
}