NetworkStream.Write メソッド

  • リファレンス

定義

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

オーバーロード

Write(ReadOnlySpan<Byte>)

読み取り専用のバイト スパンから NetworkStream にデータを書き込みます。
Write(Byte[], Int32, Int32)

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

Write(ReadOnlySpan<Byte>)

読み取り専用のバイト スパンから 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 、要求されたバイト数が送信されるか、a SocketException がスローされるまでブロックします。

注意

プロパティを呼び出CanWriteして書き込み可能かどうかをNetworkStream確認します。 書き込み不可能な NetworkStream ファイルに書き込もうとすると InvalidOperationException、.

注意

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

適用対象

Write(Byte[], Int32, Int32)

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

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int size);
public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public override void Write (byte[] buffer, int offset, int size);
public override void Write (byte[] buffer, int offset, int count);
override this.Write : byte[] * int * int -> unit
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (buffer As Byte(), offset As Integer, size As Integer)
Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

パラメーター

buffer
Byte[]

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

offset
Int32

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

sizecount
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 、要求されたバイト数が送信されるか、a SocketException がスローされるまでブロックします。

注意

プロパティを呼び出CanWriteして書き込み可能かどうかをNetworkStream確認します。 書き込み不可能な NetworkStream ファイルに書き込もうとすると InvalidOperationException、.

注意

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

こちらもご覧ください

適用対象