NetworkStream.Write メソッド

定義

名前空間:

System.Net.Sockets

アセンブリ:

System.Net.Sockets.dll

オーバーロード

Write(ReadOnlySpan<Byte>)	読み取り専用バイト スパンから に NetworkStream データを書き込みます。
Write(Byte[], Int32, Int32)	指定された範囲のバイト配列から NetworkStream にデータを書き込みます。

Write(ReadOnlySpan<Byte>)

ソース:

NetworkStream.cs

読み取り専用バイト スパンから に NetworkStream データを書き込みます。

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);

public override void Write (ReadOnlySpan<byte> buffer);

override this.Write : ReadOnlySpan<byte> -> unit

Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

パラメーター

buffer

ReadOnlySpan<Byte>

NetworkStream に書き込むデータ。

例外

InvalidOperationException

NetworkStream では、書き込みがサポートされません。

IOException

ソケットへのアクセス中にエラーが発生しました。

- または -

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

ObjectDisposedException

NetworkStream が閉じています。

注釈

このメソッドは、 buffer のすべてのバイトをネットワークに送信します。 メソッドは Write 、要求されたバイト数が送信されるか、 SocketException がスローされるまでブロックします。

注意

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

注意

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

Write(Byte[], Int32, Int32)

ソース:

NetworkStream.cs

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

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

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

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

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

パラメーター

buffer

Byte[]

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

offset

Int32

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

count

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 )
{
   array<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)
{
    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内容からネットワークにバイトを送信sizeします。 メソッドは Write 、要求されたバイト数が送信されるか、 SocketException がスローされるまでブロックします。

注意

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

注意

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

こちらもご覧ください

• CanWrite
• Writeable