NetworkStream.Read メソッド

public:
 override int Read(Span<System::Byte> buffer);

public override int Read(Span<byte> buffer);

override this.Read : Span<byte> -> int

Public Overrides Function Read (buffer As Span(Of Byte)) As Integer

パラメーター

返品

バッファーに読み込まれるバイト数の合計 (ゼロ (0) からバッファーの長さ)。 このメソッドは、0 バイトが要求された場合、またはピア ソケットが正常なシャットダウンを実行したために使用可能なバイトがなくなった場合にのみ、ゼロ (0) を返します。

例外

注釈

このメソッドは、 buffer パラメーターで使用できる量のデータを読み取り、正常に読み取られたバイト数を返します。

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

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

override this.Read : byte[] * int * int -> int

abstract member Read : byte[] * int * int -> int
override this.Read : byte[] * int * int -> int

Public Overrides Function Read (buffer As Byte(), offset As Integer, size As Integer) As Integer

パラメーター

返品

ゼロ (0) から要求されたカウントまでのバッファーに読み取られた合計バイト数。 このメソッドは、0 バイトが要求された場合、またはピア ソケットが正常なシャットダウンを実行したために使用可能なバイトがなくなった場合にのみ、ゼロ (0) を返します。

例外

例

次のコード例では、 NetworkStream からバッファーにデータを読み取ります。 データが使用可能な場合は、ストリームの末尾に達するまで読み取りが続行され、受信したデータが StringBuilderに追加されます。

byte[] myReadBuffer = new byte[1024];
StringBuilder myCompleteMessage = new StringBuilder();
int numberOfBytesRead = myNetworkStream.Read(myReadBuffer, 0, myReadBuffer.Length);

// Read all the data until the end of stream has been reached.
// The incoming message may be larger than the buffer size.
while (numberOfBytesRead > 0)
{
    myCompleteMessage.Append(Encoding.ASCII.GetString(myReadBuffer, 0, numberOfBytesRead));
    numberOfBytesRead = myNetworkStream.Read(myReadBuffer, 0, myReadBuffer.Length);
}

// Print out the received message to the console.
Console.WriteLine("You received the following message : " + myCompleteMessage);

注釈

このメソッドは、データを buffer に読み取り、正常に読み取られたバイト数を返します。 Read操作は、count パラメーターで指定されたバイト数まで、使用可能な量のデータを読み取ります。

こちらもご覧ください

• Receive(Byte[], Int32, SocketFlags)
• DataAvailable
• CanRead
• ネットワーク上のストリームの使用