NetworkStream.Write メソッド

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.dll

オーバーロード

名前	説明
Write(Byte[], Int32, Int32)	バイト配列の指定した範囲から NetworkStream にデータを書き込みます。

Write(Byte[], Int32, Int32)

バイト配列の指定した範囲から NetworkStream にデータを書き込みます。

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int size);

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

override this.Write : byte[] * int * int -> unit

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

パラメーター

buffer

Byte[]

Byteに書き込むデータを格納するNetworkStream型の配列。

offset

Int32

データの書き込みを開始する buffer 内の場所。

size

Int32

NetworkStreamに書き込むバイト数。

例外

ArgumentNullException

buffer パラメーターはnull。

ArgumentOutOfRangeException

offset パラメーターが 0 未満です。

-または-

offset パラメーターは、bufferの長さを超えています。

-または-

size パラメーターが 0 未満です。

-または-

size パラメーターは、bufferの長さからoffset パラメーターの値を引いた値を超えています。

InvalidOperationException

NetworkStreamは書き込みをサポートしていません。

IOException

ソケットにアクセスするときにエラーが発生しました。

-または-

ネットワークへの書き込み中にエラーが発生しました。

ObjectDisposedException

NetworkStream は閉じられます。

例

次のコード例では、 NetworkStream が書き込み可能かどうかを確認します。 その場合は、 Write を使用して小さなメッセージを書き込みます。

// Examples for CanWrite, and CanWrite
// Check to see if this NetworkStream is writable.
if (myNetworkStream.CanWrite)
{
    byte[] myWriteBuffer = Encoding.ASCII.GetBytes("Are you receiving this message?");
    myNetworkStream.Write(myWriteBuffer, 0, myWriteBuffer.Length);
}
else
{
    Console.WriteLine("Sorry.  You cannot write to this NetworkStream.");
}

' Examples for CanWrite, and CanWrite  
' Check to see if this NetworkStream is writable.
If myNetworkStream.CanWrite Then
   
   Dim myWriteBuffer As Byte() = Encoding.ASCII.GetBytes("Are you receiving this message?")
   myNetworkStream.Write(myWriteBuffer, 0, myWriteBuffer.Length)
Else
   Console.WriteLine("Sorry.  You cannot write to this NetworkStream.")
End If

注釈

このメソッドは、指定したoffsetから始まり、bufferの内容からネットワークにcountバイトを送信します。 Write メソッドは、要求されたバイト数が送信されるか、SocketExceptionがスローされるまでブロックします。

Note

CanWrite プロパティを呼び出して、NetworkStreamが書き込み可能かどうかを確認します。 書き込み不可能な NetworkStream に書き込もうとすると、 InvalidOperationExceptionが表示されます。

Note

IOExceptionを受け取った場合は、InnerException プロパティを調べて、SocketExceptionが原因かどうかを判断します。 その場合は、ErrorCode プロパティを使用して特定のエラー コードを取得し、エラーの詳細な説明については、Windows Sockets バージョン 2 API のエラー コードドキュメントを参照してください。

こちらもご覧ください

• CanWrite
• Writeable