NegotiateStream.EndRead(IAsyncResult) メソッド

定義

名前空間:
System.Net.Security
アセンブリ:
System.dll
アセンブリ:
netstandard.dll

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)の呼び出しで開始された非同期読み取り操作を終了します。

public:
 override int EndRead(IAsyncResult ^ asyncResult);
public override int EndRead(IAsyncResult asyncResult);
override this.EndRead : IAsyncResult -> int
Public Overrides Function EndRead (asyncResult As IAsyncResult) As Integer

パラメーター

asyncResult
IAsyncResult

IAsyncResultの呼び出しによって返されるBeginRead(Byte[], Int32, Int32, AsyncCallback, Object) インスタンス。

返品

Int32

基になるストリームから読み取られたバイト数を指定する Int32 値。

例外

ArgumentNullException

asyncResult は nullです。

ArgumentException

asyncResult は、 BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)の呼び出しによって作成されませんでした。

InvalidOperationException

完了する保留中の読み取り操作はありません。

-または-

認証が行われません。

IOException

読み取り操作に失敗しました。

例

次のコード例は、非同期読み取り操作を終了する方法を示しています。 操作の開始を示す例については、 BeginReadを参照してください。

private static void EndReadCallback(ClientState cState, int bytes)
{
    NegotiateStream authStream = (NegotiateStream)cState.AuthenticatedStream;
    // Read the client message.
    try
    {
        cState.Message.Append(Encoding.UTF8.GetChars(cState.Buffer, 0, bytes));
        if (bytes != 0)
        {
            Task<int> readTask = authStream.ReadAsync(cState.Buffer, 0, cState.Buffer.Length);
            readTask
                .ContinueWith(task => { EndReadCallback(cState, task.Result); })
                .Wait();

            return;
        }
    }
    catch (Exception e)
    {
        // A real application should do something
        // useful here, such as logging the failure.
        Console.WriteLine("Client message exception:");
        Console.WriteLine(e);
        return;
    }
    IIdentity id = authStream.RemoteIdentity;
    Console.WriteLine("{0} says {1}", id.Name, cState.Message.ToString());
}

注釈

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

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

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

適用対象