Socket.ReceiveFrom Methode

Referenz

Definition

Namespace:: System.Net.Sockets

Assembly:: System.Net.Sockets.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Empfängt ein Datagramm und speichert den Endpunkt der Quelle.

Überlädt

ReceiveFrom(Byte[], Int32, SocketFlags, EndPoint)	Empfängt mithilfe der angegebenen SocketFlags die angegebene Anzahl von Bytes im Datenpuffer und speichert den Endpunkt.
ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)	Empfängt die angegebene Anzahl von Datenbytes an der angegebenen Position im Datenpuffer, verwendet dabei die angegebenen SocketFlags und speichert den Endpunkt.
ReceiveFrom(Span<Byte>, SocketFlags, EndPoint)	Empfängt mithilfe der angegebenen SocketFlags ein Datagramm im Datenpuffer und speichert den Endpunkt.
ReceiveFrom(Byte[], SocketFlags, EndPoint)	Empfängt mithilfe der angegebenen SocketFlags ein Datagramm im Datenpuffer und speichert den Endpunkt.
ReceiveFrom(Span<Byte>, SocketFlags, SocketAddress)	Empfängt mithilfe der angegebenen SocketFlags ein Datagramm im Datenpuffer und speichert den Endpunkt.
ReceiveFrom(Span<Byte>, EndPoint)	Empfängt ein Datagramm im Datenpuffer und speichert den Endpunkt.
ReceiveFrom(Byte[], EndPoint)	Empfängt ein Datagramm im Datenpuffer und speichert den Endpunkt.

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

Quelle:: Socket.cs

Quelle:: Socket.cs

Quelle:: Socket.cs

Empfängt mithilfe der angegebenen SocketFlags die angegebene Anzahl von Bytes im Datenpuffer und speichert den Endpunkt.

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

Parameter

buffer: Byte[]

Ein Array des Typs Byte, bei dem es sich um den Speicherort für empfangene Daten handelt.

size: Int32

Die Anzahl der zu empfangenden Bytes.

socketFlags: SocketFlags

Eine bitweise Kombination der SocketFlags-Werte.

remoteEP: EndPoint

Ein Verweis auf einen EndPoint vom gleichen Typ wie der Endpunkt des Remotehosts, der bei erfolgreicher Empfangsausführung aktualisiert werden soll.

Gibt zurück

Int32

Die Anzahl der empfangenen Bytes.

Ausnahmen

ArgumentNullException

buffer ist null.

- oder -

remoteEP ist null.

ArgumentOutOfRangeException

size ist kleiner als 0.

- oder -

size ist größer als die Länge von buffer.

SocketException

socketFlags ist keine gültige Kombination von Werten.

- oder -

Die LocalEndPoint-Eigenschaft wurde nicht festgelegt.

- oder -

Beim Zugriff auf den Socket tritt ein Betriebssystemfehler auf.

ObjectDisposedException

Der Socket wurde geschlossen.

SecurityException

Ein Aufrufer in der Aufrufliste verfügt nicht über die erforderlichen Berechtigungen.

Beispiele

Das folgende Codebeispiel empfängt ein verbindungsloses Datagramm von einem Remotehost. Die Puffergröße und SocketFlags werden an die ReceiveFrom -Methode übergeben.

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

Hinweise

Die ReceiveFrom -Methode liest Daten in den buffer Parameter ein, gibt die Anzahl der Bytes zurück, die erfolgreich gelesen wurden, und erfasst den Remotehostendpunkt, von dem die Daten gesendet wurden. Diese Methode ist nützlich, wenn Sie verbindungslose Datagramme von einem unbekannten Host oder mehreren Hosts empfangen möchten.

Diese Überladung erfordert nur, dass Sie einen Empfangspuffer, die Anzahl der Bytes, die Sie empfangen möchten, die erforderliche SocketFlagsund ein EndPoint bereitstellen, das den Remotehost darstellt. Der Pufferoffset ist standardmäßig auf 0 festgelegt.

Mit verbindungslosen Protokollen liest das erste queuierte Datagramm, ReceiveFrom das in den lokalen Netzwerkpuffer empfangen wurde. Wenn das empfangene Datagramm größer als die Größe von bufferist, füllt buffer die ReceiveFrom -Methode so viele Nachrichten wie möglich aus, und löst einen ausSocketException. Wenn Sie ein unzuverlässiges Protokoll verwenden, gehen die überschüssigen Daten verloren. Wenn Sie ein zuverlässiges Protokoll verwenden, werden die überschüssigen Daten vom Dienstanbieter aufbewahrt, und Sie können sie abrufen, indem Sie die ReceiveFrom Methode mit einem ausreichend großen Puffer aufrufen.

Wenn keine Daten zum Lesen verfügbar sind, wird die ReceiveFrom -Methode blockiert, bis Daten verfügbar sind. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die ReceiveFrom -Methode sofort abgeschlossen und löst einen aus SocketException. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Obwohl ReceiveFrom für verbindungslose Protokolle vorgesehen ist, können Sie auch ein verbindungsorientiertes Protokoll verwenden. Wenn Sie sich dafür entscheiden, müssen Sie zunächst entweder eine Remotehostverbindung herstellen, indem Sie die Connect -Methode aufrufen oder eine eingehende Remotehostverbindung akzeptieren, indem Sie die Accept -Methode aufrufen. Wenn Sie vor dem Aufrufen der ReceiveFrom -Methode keine Verbindung herstellen oder akzeptieren, erhalten Sie eine SocketException. Sie können auch einen Standard-Remotehost für ein verbindungsloses Protokoll einrichten, bevor Sie die ReceiveFrom Methode aufrufen.

Mit verbindungsorientierten Sockets liest so viele Daten, wie verfügbar sind, ReceiveFrom bis zur Anzahl von Bytes, die durch den size Parameter angegeben werden. Wenn der Remotehost die Verbindung mit der Socket Shutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die ReceiveFrom Methode sofort abgeschlossen und gibt null Bytes zurück.

Hinweis

Vor dem Aufrufen ReceiveFrommüssen Sie den Socket explizit an einen lokalen Endpunkt binden, indem Sie die Bind -Methode verwenden. Wenn Sie dies nicht tun, ReceiveFrom wird ein SocketExceptionausgelöst. Wenn Sie erhalten eine SocketException, verwenden die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zur Windows Sockets-API, Version 2 .

Hinweis

Der AddressFamily der verwendeten in ReceiveFrom muss mit dem AddressFamily von übereinstimmen, der EndPoint in SendToverwendet wird.EndPoint

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Weitere Informationen

Gilt für:

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

Quelle:: Socket.cs

Quelle:: Socket.cs

Quelle:: Socket.cs

Empfängt die angegebene Anzahl von Datenbytes an der angegebenen Position im Datenpuffer, verwendet dabei die angegebenen SocketFlags und speichert den Endpunkt.

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

Parameter

buffer: Byte[]

Ein Array des Typs Byte, bei dem es sich um den Speicherort für empfangene Daten handelt.

offset: Int32

Die Position im buffer-Parameter, an der die empfangenen Daten gespeichert werden sollen.

size: Int32

Die Anzahl der zu empfangenden Bytes.

socketFlags: SocketFlags

Eine bitweise Kombination der SocketFlags-Werte.

remoteEP: EndPoint

Ein Verweis auf einen EndPoint vom gleichen Typ wie der Endpunkt des Remotehosts, der bei erfolgreicher Empfangsausführung aktualisiert werden soll.

Gibt zurück

Int32

Die Anzahl der empfangenen Bytes.

Ausnahmen

ArgumentNullException

buffer ist null.

- oder -

remoteEP ist null.

ArgumentOutOfRangeException

offset ist kleiner als 0.

- oder -

offset ist größer als die Länge von buffer.

- oder -

size ist kleiner als 0.

- oder -

size ist größer als die Länge von buffer minus dem Wert des offset-Parameters.

SocketException

socketFlags ist keine gültige Kombination von Werten.

- oder -

Die LocalEndPoint-Eigenschaft wurde nicht festgelegt.

- oder -

Fehler beim Versuch, auf den Socket zuzugreifen.

ObjectDisposedException

Der Socket wurde geschlossen.

Beispiele

Das folgende Codebeispiel empfängt ein verbindungsloses Datagramm von einem Remotehost. Der Offset, die Puffergröße und SocketFlags werden an die ReceiveFrom -Methode übergeben.

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

Hinweise

Mit verbindungsorientierten Sockets liest so viele Daten, wie verfügbar sind, ReceiveFrom bis zu der menge an Bytes, die durch den size Parameter angegeben wird. Wenn der Remotehost die Verbindung mit der Socket Shutdown -Methode herunterfährt und alle verfügbaren Daten empfangen wurden, wird die ReceiveFrom Methode sofort abgeschlossen und gibt null Bytes zurück.

Hinweis

Der AddressFamily der verwendeten in ReceiveFrom muss mit dem AddressFamily von übereinstimmen, der EndPoint in SendToverwendet wird.EndPoint

Hinweis

Weitere Informationen

Gilt für:

ReceiveFrom(Span<Byte>, SocketFlags, EndPoint)

Quelle:: Socket.cs

Quelle:: Socket.cs

Quelle:: Socket.cs

Empfängt mithilfe der angegebenen SocketFlags ein Datagramm im Datenpuffer und speichert den Endpunkt.

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

Parameter

buffer: Span<Byte>

Eine Bytespanne, die der Speicherort für empfangene Daten ist.

socketFlags: SocketFlags

Eine bitweise Kombination der SocketFlags-Werte.

remoteEP: EndPoint

Ein Verweis auf einen EndPoint vom gleichen Typ wie der Endpunkt des Remotehosts, der bei erfolgreicher Empfangsausführung aktualisiert werden soll.

Gibt zurück

Int32

Die Anzahl der empfangenen Bytes.

Ausnahmen

ArgumentNullException

remoteEP ist null.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

ObjectDisposedException

Der Socket wurde geschlossen.

Gilt für:

ReceiveFrom(Byte[], SocketFlags, EndPoint)

Quelle:: Socket.cs

Quelle:: Socket.cs

Quelle:: Socket.cs

Empfängt mithilfe der angegebenen SocketFlags ein Datagramm im Datenpuffer und speichert den Endpunkt.

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

Parameter

buffer: Byte[]

Ein Array vom Typ Byte, das der Speicherort für die empfangenen Daten ist.

socketFlags: SocketFlags

Eine bitweise Kombination der SocketFlags-Werte.

remoteEP: EndPoint

Ein Verweis auf einen EndPoint vom gleichen Typ wie der Endpunkt des Remotehosts, der bei erfolgreicher Empfangsausführung aktualisiert werden soll.

Gibt zurück

Int32

Die Anzahl der empfangenen Bytes.

Ausnahmen

ArgumentNullException

buffer ist null.

- oder -

remoteEP ist null.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

ObjectDisposedException

Der Socket wurde geschlossen.

SecurityException

Ein Aufrufer in der Aufrufliste verfügt nicht über die erforderlichen Berechtigungen.

Beispiele

Das folgende Codebeispiel empfängt ein verbindungsloses Datagramm von einem Remotehost. SocketFlags werden an die ReceiveFrom -Methode übergeben.

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

Hinweise

Diese Überladung erfordert nur, dass Sie einen Empfangspuffer, den erforderlichen SocketFlagsund einen EndPoint bereitstellen, der den Remotehost darstellt. Der Offset ist standardmäßig auf 0 und die Größe standardmäßig auf die Länge des Pufferparameters festgelegt.

Hinweis

Mit verbindungsorientierten Sockets liest so viele Daten, wie verfügbar sind, ReceiveFrom bis zur Größe von buffer. Wenn der Remotehost die Verbindung mit der Socket Shutdown -Methode herunterfährt und alle verfügbaren Daten empfangen wurden, wird die ReceiveFrom Methode sofort abgeschlossen und gibt null Bytes zurück.

Hinweis

Wenn Sie erhalten eine SocketException, verwenden die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zur Windows Sockets-API, Version 2 .

Hinweis

Der AddressFamily der verwendeten in ReceiveFrom muss mit dem AddressFamily von übereinstimmen, der EndPoint in SendToverwendet wird.EndPoint

Hinweis

Weitere Informationen

Gilt für:

ReceiveFrom(Span<Byte>, SocketFlags, SocketAddress)

Quelle:: Socket.cs

Quelle:: Socket.cs

Empfängt mithilfe der angegebenen SocketFlags ein Datagramm im Datenpuffer und speichert den Endpunkt.

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

Parameter

buffer: Span<Byte>

Eine Bytespanne, die der Speicherort für empfangene Daten ist.

socketFlags: SocketFlags

Eine bitweise Kombination der SocketFlags-Werte.

receivedAddress: SocketAddress

Eine SocketAddress instance, die mit dem Wert des Remotepeers aktualisiert wird, wenn diese Methode zurückgibt.

Gibt zurück

Int32

Die Anzahl der empfangenen Bytes.

Ausnahmen

ArgumentNullException

receivedAddress ist null.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

ObjectDisposedException

Der Socket wurde geschlossen.

Gilt für:

ReceiveFrom(Span<Byte>, EndPoint)

Quelle:: Socket.cs

Quelle:: Socket.cs

Quelle:: Socket.cs

Empfängt ein Datagramm im Datenpuffer und speichert den Endpunkt.

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

Parameter

buffer: Span<Byte>

Eine Bytespanne, die der Speicherort für empfangene Daten ist.

remoteEP: EndPoint

Ein Verweis auf einen EndPoint vom gleichen Typ wie der Endpunkt des Remotehosts, der bei erfolgreicher Empfangsausführung aktualisiert werden soll.

Gibt zurück

Int32

Die Anzahl der empfangenen Bytes.

Ausnahmen

ArgumentNullException

remoteEP ist null.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

ObjectDisposedException

Der Socket wurde geschlossen.

Gilt für:

ReceiveFrom(Byte[], EndPoint)

Quelle:: Socket.cs

Quelle:: Socket.cs

Quelle:: Socket.cs

Empfängt ein Datagramm im Datenpuffer und speichert den Endpunkt.

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

Parameter

buffer: Byte[]

Ein Array des Typs Byte, bei dem es sich um den Speicherort für empfangene Daten handelt.

remoteEP: EndPoint

Ein Verweis auf einen EndPoint vom gleichen Typ wie der Endpunkt des Remotehosts, der bei erfolgreicher Empfangsausführung aktualisiert werden soll.

Gibt zurück

Int32

Die Anzahl der empfangenen Bytes.

Ausnahmen

ArgumentNullException

buffer ist null.

- oder -

remoteEP ist null.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

ObjectDisposedException

Der Socket wurde geschlossen.

SecurityException

Ein Aufrufer in der Aufrufliste verfügt nicht über die erforderlichen Berechtigungen.

Beispiele

Das folgende Codebeispiel empfängt ein verbindungsloses Datagramm von einem Remotehost.

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

Hinweise

Diese Überladung erfordert nur, dass Sie einen Empfangs buffer- und einen EndPoint bereitstellen, der den Remotehost darstellt. Der Pufferoffset ist standardmäßig auf 0 festgelegt. Die Größe wird standardmäßig auf die Länge des buffer Parameters festgelegt, und der socketFlags Wert ist standardmäßig auf None.

Hinweis

Mit verbindungsorientierten Sockets liest so viele Daten, wie verfügbar sind, ReceiveFrom bis zur Größe von buffer. Wenn der Remotehost die Verbindung mit der Socket Shutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die ReceiveFrom Methode sofort abgeschlossen und gibt null Bytes zurück.

Hinweis

Der AddressFamily der verwendeten in ReceiveFrom muss mit dem AddressFamily von übereinstimmen, der EndPoint in SendToverwendet wird.EndPoint

Hinweis

Weitere Informationen

Gilt für:

Freigeben über

Socket.ReceiveFrom Methode

Definition

Überlädt

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

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

ReceiveFrom(Span<Byte>, SocketFlags, EndPoint)

Parameter

Gibt zurück

Ausnahmen

Gilt für:

ReceiveFrom(Byte[], SocketFlags, EndPoint)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

ReceiveFrom(Span<Byte>, SocketFlags, SocketAddress)

Parameter

Gibt zurück

Ausnahmen

Gilt für:

ReceiveFrom(Span<Byte>, EndPoint)

Parameter

Gibt zurück

Ausnahmen

Gilt für:

ReceiveFrom(Byte[], EndPoint)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen