NegotiateStream.Read メソッド

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

NegotiateStream.Read メソッド

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

このストリームからデータを読み取り、指定した配列に格納します。

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

Visual Basic (宣言)

Public Overrides Function
 Read ( _
    buffer As Byte(), _
    offset As Integer, _
    count As Integer _
) As Integer

Visual Basic (使用法)

Dim instance As NegotiateStream
Dim buffer As Byte()
Dim offset As Integer
Dim count As Integer
Dim returnValue As Integer

returnValue = instance.Read(buffer, offset, count)

C#

public override int Read (
    byte[] buffer,
    int offset,
    int count
)

C++

public:
virtual int Read (
    array<unsigned char>^ buffer, 
    int offset, 
    int count
) override

J#

public int Read (
    byte[] buffer, 
    int offset, 
    int count
)

JScript

public override function Read (
    buffer : byte[], 
    offset : int, 
    count : int
) : int

パラメータ

buffer

ストリームから読み取ったバイトを受け取る Byte 配列。

offset

このストリームから読み取ったデータの格納を開始する位置を示す、buffer 内のインデックス番号が 0 から始まる位置を格納する Int32。

count

ストリームから読み取る最大バイト数を格納する Int32。

戻り値
基になるストリームから読み取るバイト数を指定する Int32 値。読み取るデータがこれ以上存在しない場合は 0 を返します。

例外

例外の種類	条件
IOException	読み取り操作に失敗しました。
InvalidOperationException	認証が行われていません。
NotSupportedException	Read 操作は既に実行されています。

解説

このメソッドは、count で指定した最大バイトを現在のストリームから読み取り、buffer 内の offset で始まる位置に格納します。

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

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

使用例

NegotiateStream から読み取るコード例を次に示します。

C#

public static void AuthenticateClient(TcpClient
 clientRequest)
{
    NetworkStream stream = clientRequest.GetStream(); 
    // Create the NegotiateStream.
    NegotiateStream authStream = new NegotiateStream(stream, false);
    // Perform the server side of the authentication.
    authStream.AuthenticateAsServer();
    // Display properties of the authenticated client.
    IIdentity id = authStream.RemoteIdentity;
    Console.WriteLine("{0} was authenticated using {1}.",
 
        id.Name, 
        id.AuthenticationType
        );
    // Read a message from the client.
    byte [] buffer = new byte[2048];
    int charLength = authStream.Read(buffer, 0, buffer.Length);
    string messageData = new String(Encoding.UTF8.GetChars(buffer,
 0, buffer.Length));
   
    Console.WriteLine("READ {0}", messageData);
    // Finished with the current client.
    authStream.Close(); 
    // Close the client connection.
    clientRequest.Close();
}

プラットフォーム

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

参照

関連項目
NegotiateStream クラス
NegotiateStream メンバ
System.Net.Security 名前空間