NegotiateStream.Write メソッド

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

NegotiateStream.Write メソッド

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

指定したバッファとオフセットを使用して、基になるストリームに指定した Byte 数を書き込みます。

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

Visual Basic (宣言)

Public Overrides Sub Write
 ( _
    buffer As Byte(), _
    offset As Integer, _
    count As Integer _
)

Visual Basic (使用法)

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

instance.Write(buffer, offset, count)

C#

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

C++

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

J#

public void Write (
    byte[] buffer, 
    int offset, 
    int count
)

JScript

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

パラメータ

buffer

ストリームに書き込むバイトを提供する Byte 配列。

offset

ストリームに書き込むバイトの読み取りを開始する位置を示す、 buffer 内のインデックス番号が 0 から始まる位置を格納する Int32。

count

buffer から読み取るバイト数を格納する Int32。

例外

例外の種類	条件
ArgumentNullException	buffer が null 参照 (Visual Basic では Nothing) です。
ArgumentException	offset is less than 0. または offset が buffer の長さを超えています。 または offset に count を加算した値が、buffer の長さを超えています。
IOException	書き込み操作に失敗しました。 または 暗号化が使用されていますが、データを暗号化できませんでした。
NotSupportedException	既に実行中の書き込み操作が存在します。
ObjectDisposedException	このオブジェクトは閉じられています。
InvalidOperationException	認証が行われていません。

解説

暗号化、署名、または暗号化と署名が有効になっている場合、このメソッドが、バッファからのデータの読み込み、読み込んだデータの暗号化、署名、または暗号化と署名、および基になるストリームを使用したデータの送信を行います。データの暗号化や署名などのセキュリティ サービスが使用されていない場合、このメソッドは基になるストリームで M:Write を呼び出します。

このメソッドは、書き込み操作の実行中にブロックします。操作が完了するまでブロックしないようにするには、Write メソッドを使用します。

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

NegotiateStream クラスは、複数の書き込み操作の同時実行をサポートしていません。同じストリームで既に書き込み操作が実行中であるときに、別の書き込み操作を開始しようとすると、NotSupportedException 例外がスローされます。

使用例

NegotiateStream に書き込みを行うコード例を次に示します。

C#

    public static void Main(String[]
 args)  
    {
        // Establish the remote endpoint for the socket.
        // For this example, use the local machine.
        IPHostEntry ipHostInfo = Dns.GetHostEntry(Dns.GetHostName());
        IPAddress ipAddress = ipHostInfo.AddressList[0];
        // Client and server use port 11000. 
        IPEndPoint remoteEP = new IPEndPoint(ipAddress,11000);
        // Create a TCP/IP socket.
       TcpClient client = new TcpClient();
        // Connect the socket to the remote endpoint.
        client.Connect(remoteEP);
        Console.WriteLine("Client connected to {0}.",
            remoteEP.ToString());
        // Ensure the client does not close when there is 
        // still data to be sent to the server.
        client.LingerState = (new LingerOption(true
,0));
        // Request authentication.
        NetworkStream clientStream = client.GetStream();
        NegotiateStream authStream = new NegotiateStream(clientStream);
 
        // Request authentication for the client only (no mutual authentication).
        // Authenicate using the client's default credetials.
        // Permit the server to impersonate the client to access resources
 on the server only.
        // Request that data be transmitted using encryption and data
 signing.
        authStream.AuthenticateAsClient(
             (NetworkCredential) CredentialCache.DefaultCredentials, 
             "",
             ProtectionLevel.EncryptAndSign,
             TokenImpersonationLevel.Impersonation);
        DisplayAuthenticationProperties(authStream);
        DisplayStreamProperties(authStream);
        if (authStream.CanWrite)
        {
             // Encode the test data into a byte array.
            byte[] message = System.Text.Encoding.UTF8.GetBytes("Hello from
 the client.");
            authStream.Write(message, 0, message.Length);
      authStream.Flush();
            Console.WriteLine("Sent {0} bytes.", message.Length);
     }
     // Close the client connection.
        authStream.Close();
        Console.WriteLine("Client closed.");
        
}

プラットフォーム

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 名前空間