Socket.Receive メソッド

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Receive(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Receive (byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Receive : byte[] * int * int * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Receive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

注釈

メソッドは Receive 、バッファー パラメーターにデータを読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出 Receive すことができます。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホストから到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 メソッドは、 を Receive 使用 Socket.ReceiveTimeoutしてタイムアウト値が設定されていない限り、データが使用可能になるまでブロックします。 タイムアウト値を超えた場合、呼び出し Receive は を SocketExceptionスローします。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 が SocketExceptionスローされます。 ソケットへのアクセスを試行しているときにエラーが発生しました。 下記の注釈を参照してください。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行します。

接続指向SocketReceiveを使用している場合、 メソッドは、size パラメーターで指定されたバイト数まで、使用可能なだけデータを読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトが返Shutdownされます。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスからキューに登録された最初のデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズより大きい場合、bufferメッセージのbuffer最初の部分が入力され、余分なデータが失われ、 SocketException がスローされます。

こちらもご覧ください

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Receive(Span<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Receive (Span<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Receive : Span<byte> * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Receive (buffer As Span(Of Byte), socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

注釈

メソッドは Receive 、バッファー パラメーターにデータを読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出 Receive すことができます。

このオーバーロードでは、受信バッファーを指定するだけで済みます。 バッファー オフセットの既定値は 0、サイズの既定値はバッファー パラメーターの長さ、値の SocketFlags 既定値は です None。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホストから到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 メソッドは、 を Receive 使用 Socket.ReceiveTimeoutしてタイムアウト値が設定されていない限り、データが使用可能になるまでブロックします。 タイムアウト値を超えると、呼び出し Receive によって が SocketExceptionスローされます。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 が SocketExceptionスローされます。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行します。

接続指向SocketReceiveを使用している場合、 メソッドは、バッファーのサイズまで、使用可能な限り多くのデータを読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトが返Shutdownされます。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスからキューに登録された最初のデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズより大きい場合、bufferメッセージのbuffer最初の部分が入力され、余分なデータが失われ、 SocketException がスローされます。

こちらもご覧ください

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Receive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Receive (System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Receive : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Receive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

注釈

このメソッドは、 パラメーターにデータを buffers 読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出すことができます。

このオーバーロードでは、1 つ以上の受信バッファーを指定する必要があります。 値の既定値は SocketFlags です None。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホスト接続から到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 メソッドは、 を Receive 使用 Socket.ReceiveTimeoutしてタイムアウト値が設定されていない限り、データが使用可能になるまでブロックします。 タイムアウト値を超えた場合、呼び出しは Receive を SocketExceptionスローします。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 が SocketExceptionスローされます。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行します。

接続指向SocketReceiveを使用している場合、 メソッドは、バッファーのサイズまで、使用可能な限り多くのデータを読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトが返Shutdownされます。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスからキューに登録された最初のデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズより大きい場合、buffersメッセージのbuffers最初の部分が入力され、余分なデータが失われ、 SocketException がスローされます。

こちらもご覧ください

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Receive(cli::array <System::Byte> ^ buffer, int size, System::Net::Sockets::SocketFlags socketFlags);

public int Receive (byte[] buffer, int size, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : byte[] * int * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffer As Byte(), size As Integer, socketFlags As SocketFlags) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

例

以下は、 に見つかったデータをbuffer受け取り、 に をSocketFlags指定しますNone。

// Receive the host home page content and loop until all the data is received.
Int32 bytes = s->Receive( RecvBytes, RecvBytes->Length, SocketFlags::None );
strRetPage =  "Default HTML page on ";
strRetPage->Concat( server,  ":\r\n", ASCII->GetString( RecvBytes, 0, bytes ) );
while ( bytes > 0 )
{
   bytes = s->Receive( RecvBytes, RecvBytes->Length, SocketFlags::None );
   strRetPage->Concat( ASCII->GetString( RecvBytes, 0, bytes ) );
}

// Receive the host home page content and loop until all the data is received.
Int32 bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
strRetPage = "Default HTML page on " + server + ":\r\n";
strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);

while (bytes > 0)
{
  bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
  strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);
}

' Receive the host home page content and loop until all the data is received.

'Dim bytes As Int32 = s.Receive(RecvBytes, RecvBytes.Length, 0)
Dim bytes As Int32 = s.Receive(RecvBytes, RecvBytes.Length, 0)

strRetPage = "Default HTML page on " + server + ":\r\n"
strRetPage = "Default HTML page on " + server + ":" + ControlChars.Lf + ControlChars.NewLine

Dim i As Integer

While bytes > 0

  bytes = s.Receive(RecvBytes, RecvBytes.Length, 0)

  strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes)

End While

注釈

メソッドは Receive 、パラメーターにデータを buffer 読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出 Receive すことができます。

このオーバーロードでは、受信バッファー、受信するバイト数、および必要な SocketFlagsを指定するだけで済みます。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホストから到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 メソッドは、 を Receive 使用 Socket.ReceiveTimeoutしてタイムアウト値が設定されていない限り、データが使用可能になるまでブロックします。 タイムアウト値を超えた場合、呼び出し Receive は を SocketExceptionスローします。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 を SocketExceptionスローします。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行します。

接続指向SocketReceiveを使用している場合、 メソッドは、 パラメーターで指定されたバイト数まで、使用可能な限り多くのデータをsize読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトが返Shutdownされます。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスからキューに登録された最初のデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズより大きい場合、bufferメッセージのbuffer最初の部分が入力され、余分なデータが失われ、 SocketException がスローされます。

こちらもご覧ください

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Receive(Span<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags);

public int Receive (Span<byte> buffer, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : Span<byte> * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffer As Span(Of Byte), socketFlags As SocketFlags) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

注釈

メソッドは Receive 、バッファー パラメーターにデータを読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出 Receive すことができます。

このオーバーロードでは、受信バッファーを指定するだけで済みます。 バッファー オフセットの既定値は 0、サイズの既定値はバッファー パラメーターの長さ、値の SocketFlags 既定値は です None。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホストから到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 メソッドは、 を Receive 使用 Socket.ReceiveTimeoutしてタイムアウト値が設定されていない限り、データが使用可能になるまでブロックします。 タイムアウト値を超えると、呼び出し Receive によって が SocketExceptionスローされます。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 が SocketExceptionスローされます。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行します。

接続指向SocketReceiveを使用している場合、 メソッドは、バッファーのサイズまで、使用可能な限り多くのデータを読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトが返Shutdownされます。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスからキューに登録された最初のデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズより大きい場合は、bufferメッセージのbuffer最初の部分が入力され、余分なデータが失われ、 SocketException がスローされます。

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

こちらもご覧ください

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Receive(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags);

public int Receive (byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : byte[] * int * int * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

例

次のコード例では、接続 Socketされている でデータを受信する前に、データ バッファー、オフセット、サイズ、ソケット フラグを指定します。

// Displays sending with a connected socket
// using the overload that takes a buffer, offset, message size, and socket flags.
int SendReceiveTest4( Socket^ server )
{
   array<Byte>^ msg = Encoding::UTF8->GetBytes( "This is a test" );
   array<Byte>^ bytes = gcnew array<Byte>(256);
   try
   {
      
      // Blocks until send returns.
      int byteCount = server->Send( msg, 0, msg->Length, SocketFlags::None );
      Console::WriteLine( "Sent {0} bytes.", byteCount.ToString() );
      
      // Get reply from the server.
      byteCount = server->Receive( bytes, 0, server->Available,
         SocketFlags::None );
      if ( byteCount > 0 )
      {
         Console::WriteLine( Encoding::UTF8->GetString( bytes ) );
      }
   }
   catch ( SocketException^ e ) 
   {
      Console::WriteLine(  "{0} Error code: {1}.", e->Message, e->ErrorCode.ToString() );
      return (e->ErrorCode);
   }
   return 0;
}

// Displays sending with a connected socket
// using the overload that takes a buffer, offset, message size, and socket flags.
public static int SendReceiveTest4(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int byteCount = server.Send(msg, 0, msg.Length, SocketFlags.None);
        Console.WriteLine("Sent {0} bytes.", byteCount);

        // Get reply from the server.
        byteCount = server.Receive(bytes, 0, bytes.Length, SocketFlags.None);

        if (byteCount > 0)
            Console.WriteLine(Encoding.UTF8.GetString(bytes, 0, byteCount));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer, offset, message size, and socket flags.
Public Shared Function SendReceiveTest4(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim byteCount As Integer = server.Send(msg, 0, msg.Length, SocketFlags.None)
        Console.WriteLine("Sent {0} bytes.", byteCount)
        
        ' Get reply from the server.
        byteCount = server.Receive(bytes, 0, server.Available, SocketFlags.None)
        
        If byteCount > 0 Then
            Console.WriteLine(Encoding.UTF8.GetString(bytes))
        End If
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest4

注釈

メソッドは Receive 、バッファー パラメーターにデータを読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出 Receive すことができます。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホストから到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 Receive タイムアウト値が を使用して Socket.ReceiveTimeout設定されていない限り、 メソッドはデータが使用可能になるまでブロックします。 タイムアウト値を超えた場合、呼び出し Receive は を SocketExceptionスローします。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 が SocketExceptionスローされます。 ソケットへのアクセスを試行しているときにエラーが発生しました。 下記の注釈を参照してください。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行してください。

接続指向 SocketReceive の を使用している場合、 メソッドは、size パラメーターで指定されたバイト数まで、使用可能なだけデータを読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトを返Shutdownします。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスからキューに登録された最初のデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズよりも大きい場合は、bufferメッセージのbuffer最初の部分が入力され、余分なデータが失われ、 SocketException がスローされます。

こちらもご覧ください

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Receive(cli::array <System::Byte> ^ buffer, System::Net::Sockets::SocketFlags socketFlags);

public int Receive (byte[] buffer, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : byte[] * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffer As Byte(), socketFlags As SocketFlags) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

例

次のコード例では、接続されている Socketでデータを受信するための データ バッファーと SocketFlags を指定します。

// Displays sending with a connected socket
// using the overload that takes a buffer and socket flags.
int SendReceiveTest2( Socket^ server )
{
   array<Byte>^ msg = Encoding::UTF8->GetBytes( "This is a test" );
   array<Byte>^ bytes = gcnew array<Byte>(256);
   try
   {
      // Blocks until send returns.
      int byteCount = server->Send( msg, SocketFlags::None );
      Console::WriteLine( "Sent {0} bytes.", byteCount.ToString() );
      
      // Get reply from the server.
      byteCount = server->Receive( bytes, SocketFlags::None );
      if ( byteCount > 0 )
      {
         Console::WriteLine( Encoding::UTF8->GetString( bytes ) );
      }
   }
   catch ( SocketException^ e ) 
   {
      Console::WriteLine( "{0} Error code: {1}.", e->Message, e->ErrorCode.ToString() );
      return (e->ErrorCode);
   }
   return 0;
}

// Displays sending with a connected socket
// using the overload that takes a buffer and socket flags.
public static int SendReceiveTest2(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int byteCount = server.Send(msg, SocketFlags.None);
        Console.WriteLine("Sent {0} bytes.", byteCount);

        // Get reply from the server.
        byteCount = server.Receive(bytes, SocketFlags.None);
        if (byteCount > 0)
            Console.WriteLine(Encoding.UTF8.GetString(bytes));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer and socket flags.
Public Shared Function SendReceiveTest2(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim byteCount As Integer = server.Send(msg, SocketFlags.None)
        Console.WriteLine("Sent {0} bytes.", byteCount)
        
        ' Get reply from the server.
        byteCount = server.Receive(bytes, SocketFlags.None)
        If byteCount > 0 Then
            Console.WriteLine(Encoding.UTF8.GetString(bytes))
        End If
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest2

注釈

メソッドは Receive 、バッファー パラメーターにデータを読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出 Receive すことができます。

このオーバーロードでは、受信バッファーと必要 SocketFlagsな を指定するだけで済みます。 バッファー オフセットの既定値は 0 で、サイズの既定値は byte パラメーターの長さです。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホストから到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 メソッドはデータが Receive 使用可能になるまでブロックします。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 が SocketExceptionスローされます。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行してください。

接続指向 SocketReceive を使用している場合、 メソッドはバッファーのサイズまで使用可能なデータを読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトを返Shutdownします。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスから最初にエンキューされたデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズよりも大きい場合は、bufferメッセージのbuffer最初の部分が入力され、余分なデータが失われ、 SocketException がスローされます。

こちらもご覧ください

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

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

public int Receive (Span<byte> buffer);

member this.Receive : Span<byte> -> int

Public Function Receive (buffer As Span(Of Byte)) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

注釈

メソッドは Receive 、バッファー パラメーターにデータを読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出 Receive すことができます。

このオーバーロードでは、受信バッファーを指定するだけで済みます。 バッファー オフセットの既定値は 0、サイズの既定値は buffer パラメーターの長さ、値の SocketFlags 既定値は です None。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホストから到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 Receive タイムアウト値が を使用して Socket.ReceiveTimeout設定されていない限り、 メソッドはデータが使用可能になるまでブロックします。 タイムアウト値を超えると、呼び出し Receive によって が SocketExceptionスローされます。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 を SocketExceptionスローします。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行してください。

接続指向SocketReceiveを使用している場合、 メソッドは、バッファーのサイズまで、使用可能な限り多くのデータを読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトを返Shutdownします。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスからキューに登録された最初のデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズよりも大きい場合は、bufferメッセージのbuffer最初の部分が入力され、余分なデータが失われSocketException、 がスローされます。

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

こちらもご覧ください

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Receive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers);

public int Receive (System.Collections.Generic.IList<ArraySegment<byte>> buffers);

member this.Receive : System.Collections.Generic.IList<ArraySegment<byte>> -> int

Public Function Receive (buffers As IList(Of ArraySegment(Of Byte))) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

注釈

このメソッドは、buffers パラメーターにデータを読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出すことができます。

このオーバーロードでは、1 つ以上の受信バッファーを指定する必要があります。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホスト接続から到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 Receive タイムアウト値が を使用して Socket.ReceiveTimeout設定されていない限り、 メソッドはデータが使用可能になるまでブロックします。 タイムアウト値を超えた場合、呼び出し Receive は を SocketExceptionスローします。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 が SocketExceptionスローされます。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行してください。

接続指向 SocketReceive を使用している場合、 メソッドは、バッファーのサイズまで、使用可能な限り多くのデータを読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトを返Shutdownします。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスから最初にエンキューされたデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズよりも大きい場合は、buffersメッセージのbuffers最初の部分が入力され、余分なデータが失われ、 SocketException がスローされます。

メモ このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Receive(cli::array <System::Byte> ^ buffer);

public int Receive (byte[] buffer);

member this.Receive : byte[] -> int

Public Function Receive (buffer As Byte()) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

例

次のコード例では、接続されている Socket上のデータを受け取ります。

// Displays sending with a connected socket
// using the overload that takes a buffer.
int SendReceiveTest1( Socket^ server )
{
   array<Byte>^ msg = Encoding::UTF8->GetBytes( "This is a test" );
   array<Byte>^ bytes = gcnew array<Byte>(256);
   try
   {
      // Blocks until send returns.
      int byteCount = server->Send( msg );
      Console::WriteLine( "Sent {0} bytes.", byteCount.ToString() );
      
      // Get reply from the server.
      byteCount = server->Receive( bytes );
      if ( byteCount > 0 )
      {
         Console::WriteLine( Encoding::UTF8->GetString( bytes ) );
      }
   }
   catch ( SocketException^ e ) 
   {
      Console::WriteLine( "{0} Error code: {1}.", e->Message, e->ErrorCode.ToString() );
      return ( e->ErrorCode );
   }
   return 0;
}

// Displays sending with a connected socket
// using the overload that takes a buffer.
public static int SendReceiveTest1(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int i = server.Send(msg);
        Console.WriteLine("Sent {0} bytes.", i);

        // Get reply from the server.
        i = server.Receive(bytes);
        Console.WriteLine(Encoding.UTF8.GetString(bytes));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer.
Public Shared Function SendReceiveTest1(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim i As Integer = server.Send(msg)
        Console.WriteLine("Sent {0} bytes.", i)
        
        ' Get reply from the server.
        i = server.Receive(bytes)
        Console.WriteLine(Encoding.UTF8.GetString(bytes))
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest1

注釈

メソッドは Receive 、バッファー パラメーターにデータを読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出 Receive すことができます。

このオーバーロードでは、受信バッファーを指定するだけで済みます。 バッファー オフセットの既定値は 0、サイズの既定値は buffer パラメーターの長さ、値の SocketFlags 既定値は です None。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホストから到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 Receive タイムアウト値が を使用して Socket.ReceiveTimeout設定されていない限り、 メソッドはデータが使用可能になるまでブロックします。 タイムアウト値を超えた場合、呼び出し Receive は を SocketExceptionスローします。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 が SocketExceptionスローされます。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行してください。

接続指向 SocketReceive を使用している場合、 メソッドは、バッファーのサイズまで、使用可能な限り多くのデータを読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトを返Shutdownします。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスからキューに登録された最初のデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズよりも大きい場合は、bufferメッセージのbuffer最初の部分が入力され、余分なデータが失われ、 SocketException がスローされます。

こちらもご覧ください

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

ソース:

Socket.cs

ソース:

Socket.cs

ソース:

Socket.cs

public:
 int Receive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags);

public int Receive (System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags) As Integer

パラメーター

戻り値

受信されたバイト数。

例外

例

次のコード例は、接続されている Socketでデータを受信する方法を示しています。

// Build the buffers for the receive.
List<ArraySegment<Byte> >^ receiveBuffers = 
    gcnew List<ArraySegment<Byte> >(2);

array<Byte>^ bigBuffer = gcnew array<Byte>(1024);

// Specify the first buffer segment (2 bytes, starting 
// at the 4th element of bigBuffer)
receiveBuffers->Add(ArraySegment<Byte>(bigBuffer, 4, 2));

// Specify the second buffer segment (500 bytes, starting
// at the 20th element of bigBuffer)
receiveBuffers->Add(
    ArraySegment<Byte>(bigBuffer, 20, 500));

tcpSocket->Receive(receiveBuffers);

Console::WriteLine("{0}", 
    asciiEncoding->GetString(bigBuffer));

// Build the buffers for the receive.
List<ArraySegment<byte>> recvBuffers =
                         new List<ArraySegment<byte>>(2);

byte[] bigBuffer = new byte[1024];

// Specify the first buffer segment (2 bytes, starting
// at the 4th element of bigBuffer)
recvBuffers.Add(new ArraySegment<byte>(bigBuffer, 4, 2));

// Specify the second buffer segment (500 bytes, starting
// at the 20th element of bigBuffer)
recvBuffers.Add(new ArraySegment<byte>(bigBuffer, 20, 500));

int bytesReceived = mySocket.Receive(recvBuffers);

Console.WriteLine("{0}", ASCII.GetString(bigBuffer));

注釈

このメソッドは、 パラメーターにデータを buffers 読み取り、正常に読み取られたバイト数を返します。 接続指向ソケットとコネクションレス ソケットの両方から を呼び出すことができます。

このオーバーロードでは、1 つ以上の受信バッファーを指定する必要があります。 値の既定値は SocketFlags です None。

接続指向プロトコルを使用している場合は、 を呼び出してリモート ホスト接続を確立するかAccept、 を呼び出ConnectすReceive前に着信接続を受け入れる必要があります。 メソッドはReceive、 メソッドまたは Accept メソッドでConnect確立されたリモート ホスト接続から到着したデータのみを読み取ります。 コネクションレス プロトコルを使用している場合は、 メソッドを ReceiveFrom 使用することもできます。 ReceiveFrom では、任意のホストから到着するデータを受信できます。

読み取りに使用できるデータがない場合、 Receive タイムアウト値が を使用して Socket.ReceiveTimeout設定されていない限り、 メソッドはデータが使用可能になるまでブロックします。 タイムアウト値を超えた場合、呼び出し Receive は を SocketExceptionスローします。 非ブロッキング モードで、プロトコル スタック バッファーに使用可能なデータがない場合、 Receive メソッドはすぐに完了し、 が SocketExceptionスローされます。 プロパティを Available 使用して、データが読み取り可能かどうかを判断できます。 が 0 以外の場合 Available は、受信操作を再試行してください。

接続指向 SocketReceive を使用している場合、 メソッドは、バッファーのサイズまで、使用可能な限り多くのデータを読み取ります。 リモート ホストが メソッドとの接続をSocketシャットダウンし、使用可能なすべてのデータを受信した場合、メソッドはすぐに完了し、Receive0 バイトを返Shutdownします。

コネクションレス SocketReceive を使用している場合は、 メソッドで指定した宛先アドレスから最初にエンキューされたデータグラムがConnect読み取られます。 受信したデータグラムがパラメーターのサイズよりも大きい場合は、buffersメッセージのbuffers最初の部分が入力され、余分なデータが失われ、 SocketException がスローされます。

こちらもご覧ください

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()