NetworkStream.Write メソッド

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

NetworkStream.Write メソッド

NetworkStream にデータを書き込みます。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As NetworkStream
Dim buffer As Byte()
Dim offset As Integer
Dim size As Integer

instance.Write(buffer, offset, size)

C#

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

C++

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

J#

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

JScript

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

パラメータ

buffer

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

offset

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

size

NetworkStream に書き込むバイト数。

例外

例外の種類	条件
ArgumentNullException	buffer が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	offset が 0 未満です。 または offset が buffer の長さを超えています。 または size が 0 未満です。 または size が、buffer の長さから offset パラメータの値を引いた値を超えています。
IOException	ネットワークへの書き込み中にエラーが発生しました。 または ソケットへのアクセス中にエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	NetworkStream が閉じています。 または ネットワークからの読み取りでエラーが発生しました。

解説

Write メソッドは、指定した offset から始まり、buffer の内容の size バイトをネットワークに送信します。Write メソッドは、要求されたバイト数が送信されるか、SocketException がスローされるまでブロックします。SocketException が発生した場合は、SocketException.ErrorCode プロパティを使用して特定のエラー コードを取得してください。エラーの詳細については、MSDN で Windows Socket Version 2 API のエラー コードのドキュメントを参照してください。

メモ
CanWrite プロパティにアクセスして、NetworkStream が書き込み可能かどうかを確認します。書き込むことができない NetworkStream に書き込もうとすると、IOException が発生します。IOException が発生した場合は、InnerException プロパティをチェックして、この原因が SocketException かどうかを確認してください。

使用例

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

Visual Basic

' 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

C#

           
// 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.");  
}

J#

// Check to see if this NetworkStream is writable.
if (myNetworkStream.get_CanWrite()) {
    ubyte myWriteBuffer[] = Encoding.get_ASCII().
        GetBytes("Are you receiving this message?");
    myNetworkStream.Write(myWriteBuffer, 0, 
        myWriteBuffer.get_Length());
}
else {
    Console.WriteLine("Sorry.  You cannot write to this "
        + "NetworkStream.");
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
NetworkStream クラス
NetworkStream メンバ
System.Net.Sockets 名前空間
CanWrite
Writeable