Socket.ReceiveFrom メソッド

リファレンス

定義

名前空間:: System.Net.Sockets

アセンブリ:: System.Net.Sockets.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

データグラムを受信し、ソースエンドポイントを格納します。

オーバーロード

ReceiveFrom(Byte[], Int32, SocketFlags, EndPoint)	指定した SocketFlags を使用し、指定したバイト数のデータを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。
ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)	指定した SocketFlags を使用して、指定したバイト数のデータを受信して、データバッファー内の指定した位置に格納します。またエンドポイントを格納します。
ReceiveFrom(Span<Byte>, SocketFlags, EndPoint)	指定した SocketFlags を使用し、データグラムを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。
ReceiveFrom(Byte[], SocketFlags, EndPoint)	指定した SocketFlags を使用し、データグラムを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。
ReceiveFrom(Span<Byte>, SocketFlags, SocketAddress)	指定した SocketFlags を使用し、データグラムを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。
ReceiveFrom(Span<Byte>, EndPoint)	データグラムを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。
ReceiveFrom(Byte[], EndPoint)	データグラムを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。

ReceiveFrom(Byte[], Int32, SocketFlags, EndPoint)

指定した SocketFlags を使用し、指定したバイト数のデータを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。

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

public int ReceiveFrom (byte[] buffer, int size, System.Net.Sockets.SocketFlags socketFlags, ref System.Net.EndPoint remoteEP);

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

Public Function ReceiveFrom (buffer As Byte(), size As Integer, socketFlags As SocketFlags, ByRef remoteEP As EndPoint) As Integer

パラメーター

buffer: Byte[]

受信したデータの格納場所である、Byte 型の配列。

size: Int32

受信するバイト数。

socketFlags: SocketFlags

SocketFlags 値のビットごとの組み合わせ。

remoteEP: EndPoint

正常な受信時に EndPoint 更新されるリモートホストのエンドポイントと同じ型のへの参照。

戻り値

Int32

受信されたバイト数。

例外

ArgumentNullException

buffer が nullです。

または

remoteEP が nullです。

ArgumentOutOfRangeException

size が 0 未満です。

または

size が bufferの長さを超えています。

SocketException

socketFlags は、値の有効な組み合わせではありません。

- または -

LocalEndPoint プロパティが設定されていませんでした。

- または -

Socket にアクセス中にオペレーティングシステムエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

SecurityException

コールスタック内の呼び出し元が、必要なアクセス許可を保持していません。

例

次のコード例では、リモートホストからコネクションレスデータグラムを受信します。バッファーサイズと SocketFlags は、メソッドに ReceiveFrom 渡されます。

static void ReceiveFrom3()
{
   IPHostEntry^ hostEntry = Dns::Resolve( Dns::GetHostName() );
   IPEndPoint^ endPoint = gcnew IPEndPoint( hostEntry->AddressList[ 0 ],11000 );

   Socket^ s = gcnew Socket( endPoint->Address->AddressFamily,
      SocketType::Dgram,
      ProtocolType::Udp );
   
   // Creates an IPEndPoint to capture the identity of the sending host.
   IPEndPoint^ sender = gcnew IPEndPoint( IPAddress::Any,0 );
   EndPoint^ senderRemote = safe_cast<EndPoint^>(sender);
   
   // Binding is required with ReceiveFrom calls.
   s->Bind( endPoint );

   array<Byte>^ msg = gcnew array<Byte>(256);
   Console::WriteLine(  "SWaiting to receive datagrams from client..." );
   // This call blocks. 
   s->ReceiveFrom( msg, msg->Length, SocketFlags::None, senderRemote );
   s->Close();
}

public static void ReceiveFrom3()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    // Creates an IPEndPoint to capture the identity of the sending host.
    IPEndPoint sender = new IPEndPoint(IPAddress.Any, 0);
    EndPoint senderRemote = (EndPoint)sender;

    // Binding is required with ReceiveFrom calls.
    s.Bind(endPoint);

    byte[] msg = new Byte[256];
    Console.WriteLine("Waiting to receive datagrams from client...");
    // This call blocks.
    s.ReceiveFrom(msg, msg.Length, SocketFlags.None, ref senderRemote);
    s.Close();
}

Public Shared Sub ReceiveFrom3() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    ' Creates an IPEndPoint to capture the identity of the sending host.
    Dim sender As New IPEndPoint(IPAddress.Any, 0)
    Dim senderRemote As EndPoint = CType(sender, EndPoint)
    
    ' Binding is required with ReceiveFrom calls.
    s.Bind(endPoint)
    
    Dim msg() As Byte = New [Byte](255) {}
    Console.WriteLine("Waiting to receive datagrams from client...")
    ' This call blocks. 
    s.ReceiveFrom(msg, msg.Length, SocketFlags.None, senderRemote)
    s.Close()

End Sub

注釈

メソッドは ReceiveFrom 、パラメーターにデータを buffer 読み取り、正常に読み取られたバイト数を返し、データの送信元のリモートホストエンドポイントをキャプチャします。この方法は、不明なホストまたは複数のホストからコネクションレスデータグラムを受信する場合に便利です。

このオーバーロードでは、受信バッファー、受信するバイト数、必要な SocketFlags、およびリモートホストを表すを EndPoint 指定するだけで済みます。バッファーオフセットの既定値は 0 です。

コネクションレスプロトコルでは、は、 ReceiveFrom ローカルネットワークバッファーに受信した最初のエンキューされたデータグラムを読み取ります。受信したデータグラムがのbufferReceiveFromサイズより大きい場合、メソッドは可能な限り多くのメッセージを入力bufferし、をSocketExceptionスローします。信頼性の低いプロトコルを使用している場合、過剰なデータは失われます。信頼できるプロトコルを使用している場合、過剰なデータはサービスプロバイダーによって保持され、十分な大きさのバッファーでメソッドを ReceiveFrom 呼び出すことで取得できます。

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

はコネクションレスプロトコルを対象としていますが ReceiveFrom 、接続指向プロトコルも使用できます。これを行う場合は、まずメソッドを呼び出してリモートホスト接続を確立するか、メソッドを Connect 呼び出して受信リモートホスト接続を Accept 受け入れる必要があります。メソッドを呼び出す ReceiveFrom 前に接続を確立または受け入れなかった場合は、が SocketException表示されます。メソッドを呼び出す前に、コネクションレスプロトコルの既定のリモートホストを ReceiveFrom 確立することもできます。

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

注意

を呼び出す ReceiveFrom前に、メソッドを使用してをローカルエンドポイントに明示的にバインド Socket する Bind 必要があります。そうでない場合は、 ReceiveFrom がスロー SocketExceptionされます。を受け取った場合は SocketException、プロパティを SocketException.ErrorCode 使用して特定のエラーコードを取得します。このコードを取得したら、エラーの詳細な説明については、 Windows ソケットバージョン 2 API エラーコードのドキュメントを参照してください。

注意

で使用されるの EndPoint はAddressFamily、でReceiveFrom使用されるのとEndPoint SendTo一致AddressFamilyする必要があります。

Note

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

こちらもご覧ください

適用対象

ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)

指定した SocketFlags を使用して、指定したバイト数のデータを受信して、データバッファー内の指定した位置に格納します。またエンドポイントを格納します。

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

public int ReceiveFrom (byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, ref System.Net.EndPoint remoteEP);

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

Public Function ReceiveFrom (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, ByRef remoteEP As EndPoint) As Integer

パラメーター

buffer: Byte[]

受信したデータの格納場所である、Byte 型の配列。

offset: Int32

受信したデータを格納する、buffer パラメーター内の位置。

size: Int32

受信するバイト数。

socketFlags: SocketFlags

SocketFlags 値のビットごとの組み合わせ。

remoteEP: EndPoint

正常な受信時に EndPoint 更新されるリモートホストのエンドポイントと同じ型のへの参照。

戻り値

Int32

受信されたバイト数。

例外

ArgumentNullException

buffer が nullです。

または

remoteEP が nullです。

ArgumentOutOfRangeException

offset が 0 未満です。

または

offset が buffer の長さを超えています。

または

size が 0 未満です。

- または -

size が、buffer の長さからオフセットパラメーターの値を引いた値を超えています。

SocketException

socketFlags は、値の有効な組み合わせではありません。

- または -

LocalEndPoint プロパティが設定されていませんでした。

- または -

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

例

次のコード例では、リモートホストからコネクションレスデータグラムを受信します。オフセット、バッファーサイズ、および SocketFlags がメソッドに ReceiveFrom 渡されます。

static void ReceiveFrom4()
{
   IPHostEntry^ hostEntry = Dns::Resolve( Dns::GetHostName() );
   IPEndPoint^ endPoint = gcnew IPEndPoint( hostEntry->AddressList[ 0 ],11000 );

   Socket^ s = gcnew Socket( endPoint->Address->AddressFamily,
      SocketType::Dgram,
      ProtocolType::Udp );
   
   // Creates an IpEndPoint to capture the identity of the sending host.
   IPEndPoint^ sender = gcnew IPEndPoint( IPAddress::Any,0 );
   EndPoint^ senderRemote = safe_cast<EndPoint^>(sender);
   
   // Binding is required with ReceiveFrom calls.
   s->Bind( endPoint );

   array<Byte>^ msg = gcnew array<Byte>(256);
   Console::WriteLine(  "SWaiting to receive datagrams from client..." );
   // This call blocks.  
   s->ReceiveFrom( msg, 0, msg->Length, SocketFlags::None, senderRemote );
   s->Close();
}

public static void ReceiveFrom4()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    // Creates an IpEndPoint to capture the identity of the sending host.
    IPEndPoint sender = new IPEndPoint(IPAddress.Any, 0);
    EndPoint senderRemote = (EndPoint)sender;

    // Binding is required with ReceiveFrom calls.
    s.Bind(endPoint);
    byte[] msg = new Byte[256];
    Console.WriteLine("Waiting to receive datagrams from client...");
    // This call blocks.
    s.ReceiveFrom(msg, 0, msg.Length, SocketFlags.None, ref senderRemote);
    s.Close();
}

Public Shared Sub ReceiveFrom4() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    ' Creates an IpEndPoint to capture the identity of the sending host.
    Dim sender As New IPEndPoint(IPAddress.Any, 0)
    Dim senderRemote As EndPoint = CType(sender, EndPoint)
    
    ' Binding is required with ReceiveFrom calls.
    s.Bind(endPoint)
    Dim msg() As Byte = New [Byte](255) {}
    Console.WriteLine("Waiting to receive datagrams from client...")
    ' This call blocks.  
    s.ReceiveFrom(msg, 0, msg.Length, SocketFlags.None, senderRemote)
    s.Close()

End Sub

注釈

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

注意

で使用されるの EndPoint はAddressFamily、でReceiveFrom使用されるのとEndPoint SendTo一致AddressFamilyする必要があります。

Note

こちらもご覧ください

適用対象

ReceiveFrom(Span<Byte>, SocketFlags, EndPoint)

指定した SocketFlags を使用し、データグラムを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。

public:
 int ReceiveFrom(Span<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ % remoteEP);

public int ReceiveFrom (Span<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, ref System.Net.EndPoint remoteEP);

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

Public Function ReceiveFrom (buffer As Span(Of Byte), socketFlags As SocketFlags, ByRef remoteEP As EndPoint) As Integer

パラメーター

buffer: Span<Byte>

受信したデータの格納場所であるバイトのスパン。

socketFlags: SocketFlags

SocketFlags 値のビットごとの組み合わせ。

remoteEP: EndPoint

正常な受信時に EndPoint 更新されるリモートホストのエンドポイントと同じ型のへの参照。

戻り値

Int32

受信されたバイト数。

例外

ArgumentNullException

remoteEP が nullです。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

適用対象

ReceiveFrom(Byte[], SocketFlags, EndPoint)

指定した SocketFlags を使用し、データグラムを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。

public:
 int ReceiveFrom(cli::array <System::Byte> ^ buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ % remoteEP);

public int ReceiveFrom (byte[] buffer, System.Net.Sockets.SocketFlags socketFlags, ref System.Net.EndPoint remoteEP);

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

Public Function ReceiveFrom (buffer As Byte(), socketFlags As SocketFlags, ByRef remoteEP As EndPoint) As Integer

パラメーター

buffer: Byte[]

受信したデータの保存場所となる Byte 型の配列。

socketFlags: SocketFlags

SocketFlags 値のビットごとの組み合わせ。

remoteEP: EndPoint

正常な受信時に EndPoint 更新されるリモートホストのエンドポイントと同じ型のへの参照。

戻り値

Int32

受信されたバイト数。

例外

ArgumentNullException

buffer が nullです。

または

remoteEP が nullです。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

SecurityException

コールスタック内の呼び出し元が、必要なアクセス許可を保持していません。

例

次のコード例では、リモートホストからコネクションレスデータグラムを受信します。 SocketFlags がメソッドに ReceiveFrom 渡されます。

static void ReceiveFrom2()
{
   IPHostEntry^ hostEntry = Dns::Resolve( Dns::GetHostName() );
   IPEndPoint^ endPoint = gcnew IPEndPoint( hostEntry->AddressList[ 0 ],11000 );

   Socket^ s = gcnew Socket( endPoint->Address->AddressFamily,
      SocketType::Dgram,
      ProtocolType::Udp );
   
   // Creates an IpEndPoint to capture the identity of the sending host.
   IPEndPoint^ sender = gcnew IPEndPoint( IPAddress::Any,0 );
   EndPoint^ senderRemote = safe_cast<EndPoint^>(sender);
   
   // Binding is required with ReceiveFrom calls.
   s->Bind( endPoint );

   array<Byte>^ msg = gcnew array<Byte>(256);
   Console::WriteLine( "Waiting to receive datagrams from client..." );
   // This call blocks. 
   s->ReceiveFrom( msg, SocketFlags::None, senderRemote );
   s->Close();
}

public static void ReceiveFrom2()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    // Creates an IpEndPoint to capture the identity of the sending host.
    IPEndPoint sender = new IPEndPoint(IPAddress.Any, 0);
    EndPoint senderRemote = (EndPoint)sender;

    // Binding is required with ReceiveFrom calls.
    s.Bind(endPoint);

    byte[] msg = new Byte[256];
    Console.WriteLine("Waiting to receive datagrams from client...");
    // This call blocks.
    s.ReceiveFrom(msg, SocketFlags.None, ref senderRemote);
    s.Close();
}

Public Shared Sub ReceiveFrom2() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    ' Creates an IpEndPoint to capture the identity of the sending host.
    Dim sender As New IPEndPoint(IPAddress.Any, 0)
    Dim senderRemote As EndPoint = CType(sender, EndPoint)
    
    ' Binding is required with ReceiveFrom calls.
    s.Bind(endPoint)
    
    Dim msg() As Byte = New [Byte](255) {}
    Console.WriteLine("Waiting to receive datagrams from client...")
    ' This call blocks. 
    s.ReceiveFrom(msg, SocketFlags.None, senderRemote)
    s.Close()

End Sub

注釈

このオーバーロードでは、リモートホストを表す受信バッファー、必要な SocketFlags、およびを EndPoint 指定するだけで済みます。オフセットの既定値は 0 で、サイズの既定値は buffer パラメーターの長さです。

注意

を呼び出す ReceiveFrom前に、メソッドを使用してをローカルエンドポイントに明示的にバインド Socket する Bind 必要があります。そうでない場合は、 ReceiveFrom がスロー SocketExceptionされます。

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

注意

を受け取った場合は SocketException、プロパティを SocketException.ErrorCode 使用して特定のエラーコードを取得します。このコードを取得したら、エラーの詳細な説明については、 Windows ソケットバージョン 2 API エラーコードのドキュメントを参照してください。

注意

で使用されるの EndPoint はAddressFamily、でReceiveFrom使用されるのとEndPoint SendTo一致AddressFamilyする必要があります。

Note

こちらもご覧ください

適用対象

ReceiveFrom(Span<Byte>, SocketFlags, SocketAddress)

指定した SocketFlags を使用し、データグラムを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。

public:
 int ReceiveFrom(Span<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::SocketAddress ^ receivedAddress);

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

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

Public Function ReceiveFrom (buffer As Span(Of Byte), socketFlags As SocketFlags, receivedAddress As SocketAddress) As Integer

パラメーター

buffer: Span<Byte>

受信したデータの格納場所であるバイトのスパン。

socketFlags: SocketFlags

SocketFlags 値のビットごとの組み合わせ。

receivedAddress: SocketAddress

SocketAddressこのメソッドが返されるときに、リモートピアの値で更新されるインスタンス。

戻り値

Int32

受信されたバイト数。

例外

ArgumentNullException

receivedAddress が nullです。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

適用対象

ReceiveFrom(Span<Byte>, EndPoint)

データグラムを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。

public:
 int ReceiveFrom(Span<System::Byte> buffer, System::Net::EndPoint ^ % remoteEP);

public int ReceiveFrom (Span<byte> buffer, ref System.Net.EndPoint remoteEP);

member this.ReceiveFrom : Span<byte> * EndPoint -> int

Public Function ReceiveFrom (buffer As Span(Of Byte), ByRef remoteEP As EndPoint) As Integer

パラメーター

buffer: Span<Byte>

受信したデータの格納場所であるバイトのスパン。

remoteEP: EndPoint

正常な受信時に EndPoint 更新されるリモートホストのエンドポイントと同じ型のへの参照。

戻り値

Int32

受信されたバイト数。

例外

ArgumentNullException

remoteEP が nullです。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

適用対象

ReceiveFrom(Byte[], EndPoint)

データグラムを受信してデータバッファーに格納します。さらに、エンドポイントを格納します。

public:
 int ReceiveFrom(cli::array <System::Byte> ^ buffer, System::Net::EndPoint ^ % remoteEP);

public int ReceiveFrom (byte[] buffer, ref System.Net.EndPoint remoteEP);

member this.ReceiveFrom : byte[] * EndPoint -> int

Public Function ReceiveFrom (buffer As Byte(), ByRef remoteEP As EndPoint) As Integer

パラメーター

buffer: Byte[]

受信したデータの格納場所である、Byte 型の配列。

remoteEP: EndPoint

正常な受信時に EndPoint 更新されるリモートホストのエンドポイントと同じ型のへの参照。

戻り値

Int32

受信されたバイト数。

例外

ArgumentNullException

buffer が nullです。

または

remoteEP が nullです。

SocketException

ソケットへのアクセスを試行しているときにエラーが発生しました。

ObjectDisposedException

Socket が閉じられました。

SecurityException

コールスタック内の呼び出し元が、必要なアクセス許可を保持していません。

例

次のコード例では、リモートホストからコネクションレスデータグラムを受信します。

static void ReceiveFrom1()
{
   IPHostEntry^ hostEntry = Dns::Resolve( Dns::GetHostName() );
   IPEndPoint^ endPoint = gcnew IPEndPoint( hostEntry->AddressList[ 0 ],11000 );

   Socket^ s = gcnew Socket( endPoint->Address->AddressFamily,
      SocketType::Dgram,
      ProtocolType::Udp );
   
   // Creates an IPEndPoint to capture the identity of the sending host.
   IPEndPoint^ sender = gcnew IPEndPoint( IPAddress::Any,0 );
   EndPoint^ senderRemote = safe_cast<EndPoint^>(sender);
   
   // Binding is required with ReceiveFrom calls.
   s->Bind( endPoint );

   array<Byte>^ msg = gcnew array<Byte>(256);
   Console::WriteLine( "Waiting to receive datagrams from client..." );
   
   // This call blocks. 
   s->ReceiveFrom( msg, senderRemote );
   s->Close();
}

public static void ReceiveFrom1()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    // Creates an IPEndPoint to capture the identity of the sending host.
    IPEndPoint sender = new IPEndPoint(IPAddress.Any, 0);
    EndPoint senderRemote = (EndPoint)sender;

    // Binding is required with ReceiveFrom calls.
    s.Bind(endPoint);

    byte[] msg = new Byte[256];
    Console.WriteLine("Waiting to receive datagrams from client...");

    // This call blocks.
    s.ReceiveFrom(msg, ref senderRemote);
    s.Close();
}

Public Shared Sub ReceiveFrom1() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    ' Creates an IPEndPoint to capture the identity of the sending host.
    Dim sender As New IPEndPoint(IPAddress.Any, 0)
    Dim senderRemote As EndPoint = CType(sender, EndPoint)
    
    ' Binding is required with ReceiveFrom calls.
    s.Bind(endPoint)
    
    Dim msg() As Byte = New [Byte](255) {}
    Console.WriteLine("Waiting to receive datagrams from client...")
    
    ' This call blocks. 
    s.ReceiveFrom(msg, senderRemote)
    s.Close()

End Sub

注釈

このオーバーロードでは、リモートホストを表す受信 buffer、およびを EndPoint 指定する必要があります。バッファーオフセットの既定値は 0 です。サイズの既定値はパラメーターの長さで buffer 、値の socketFlags 既定値はです None。

注意

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

注意

で使用されるの EndPoint はAddressFamily、でReceiveFrom使用されるのとEndPoint SendTo一致AddressFamilyする必要があります。

Note

こちらもご覧ください

適用対象

Socket.ReceiveFrom メソッド

定義

オーバーロード

ReceiveFrom(Byte[], Int32, SocketFlags, EndPoint)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ReceiveFrom(Span<Byte>, SocketFlags, EndPoint)

パラメーター

戻り値

例外

適用対象

ReceiveFrom(Byte[], SocketFlags, EndPoint)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ReceiveFrom(Span<Byte>, SocketFlags, SocketAddress)

パラメーター

戻り値

例外

適用対象

ReceiveFrom(Span<Byte>, EndPoint)

パラメーター

戻り値

例外

適用対象

ReceiveFrom(Byte[], EndPoint)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース