UdpClient.Receive-Methode

Gibt ein von einem Remotehost gesendetes UDP-Datagramm zurück.

Namespace: System.Net.Sockets
Assembly: System (in system.dll)

Syntax

'Declaration
Public Function Receive ( _
    ByRef remoteEP As IPEndPoint _
) As Byte()
'Usage
Dim instance As UdpClient
Dim remoteEP As IPEndPoint
Dim returnValue As Byte()

returnValue = instance.Receive(remoteEP)

public byte[] Receive (
    ref IPEndPoint remoteEP
)

public:
array<unsigned char>^ Receive (
    IPEndPoint^% remoteEP
)

public byte[] Receive (
    /** @ref */ IPEndPoint remoteEP
)

JScript unterstützt die Übergabe von Werttypargumenten als Verweis nicht.

Parameter

• remoteEP
  Ein IPEndPoint, der den Remotehost darstellt, von dem die Daten gesendet wurden.

Rückgabewert

Ein Array vom Typ Byte, das Datagrammdaten enthält.

Ausnahmen

Ausnahmetyp	Bedingung
ObjectDisposedException	Der zugrunde liegende Socket wurde geschlossen.
SocketException	Fehler beim Zugriff auf den Socket. Weitere Informationen finden Sie im Abschnitt "Hinweise".

Hinweise

Die Receive-Methode blockiert, bis ein Datagramm von einem Remotehost eintrifft. Wenn Daten zur Verfügung stehen, liest die Receive-Methode das erste Datagramm in der Warteschlange und gibt den Datenteil als Bytearray zurück. Diese Methode füllt den remoteEP-Parameter mit der IPAddress und der Anschlussnummer des Absenders.

Wenn Sie in der Connect-Methode einen Standardremotehost angeben, akzeptiert die Receive-Methode nur Datagramme von diesem Host. Alle anderen Datagramme werden verworfen.

Wenn Sie eine SocketException erhalten, können Sie mit SocketException.ErrorCode den spezifischen Fehlercode abrufen. Nachdem Sie diesen Code abgerufen haben, finden Sie in MSDN in der Dokumentation zu API-Fehlercodes unter Windows Socket, Version 2, eine ausführliche Beschreibung des Fehlers.

Hinweis

Wenn Sie Multicastdatagramme empfangen möchten, rufen Sie die Connect-Methode nicht vor dem Aufruf der Receive-Methode auf. Der UdpClient, mit dem Datagramme empfangen werden sollen, muss mit der Multicastanschlussnummer erstellt werden.

Beispiel

Im folgenden Beispiel wird die Receive-Methode veranschaulicht. Die Receive-Methode blockiert die Ausführung, bis sie eine Meldung empfängt. Die Identität des antwortenden Hosts wird mithilfe des an Receive übergebenen IPEndPoint erkennbar.

   'Creates a UdpClient for reading incoming data.
   Dim receivingUdpClient As New UdpClient(11000)
   
   'Creates an IPEndPoint to record the IP address and port number of the sender. 
   ' The IPEndPoint will allow you to read datagrams sent from any source.
   Dim RemoteIpEndPoint As New IPEndPoint(IPAddress.Any, 0)
   Try
      
      ' Blocks until a message returns on this socket from a remote host.
      Dim receiveBytes As [Byte]() = receivingUdpClient.Receive(RemoteIpEndPoint)
      
      Dim returnData As String = Encoding.ASCII.GetString(receiveBytes)
      
      Console.WriteLine(("This is the message you received " + returnData.ToString()))
      Console.WriteLine(("This message was sent from " + RemoteIpEndPoint.Address.ToString() + " on their port number " + RemoteIpEndPoint.Port.ToString()))
   Catch e As Exception
      Console.WriteLine(e.ToString())
   End Try
End Sub 'MyUdpClientCommunicator
 

 //Creates a UdpClient for reading incoming data.
 UdpClient receivingUdpClient = new UdpClient(11000);

 //Creates an IPEndPoint to record the IP Address and port number of the sender. 
// The IPEndPoint will allow you to read datagrams sent from any source.
 IPEndPoint RemoteIpEndPoint = new IPEndPoint(IPAddress.Any, 0);
 try{

     // Blocks until a message returns on this socket from a remote host.
     Byte[] receiveBytes = receivingUdpClient.Receive(ref RemoteIpEndPoint); 

     string returnData = Encoding.ASCII.GetString(receiveBytes);
 
     Console.WriteLine("This is the message you received " +
                                  returnData.ToString());
     Console.WriteLine("This message was sent from " +
                                 RemoteIpEndPoint.Address.ToString() +
                                 " on their port number " +
                                 RemoteIpEndPoint.Port.ToString());
 }
 catch ( Exception e ){
     Console.WriteLine(e.ToString()); 
 }
 

//Creates a UdpClient for reading incoming data.
UdpClient^ receivingUdpClient = gcnew UdpClient( 11000 );

//Creates an IPEndPoint to record the IP Address and port number of the sender. 
// The IPEndPoint will allow you to read datagrams sent from any source.
IPEndPoint^ RemoteIpEndPoint = gcnew IPEndPoint( IPAddress::Any,0 );
try
{
   // Blocks until a message returns on this socket from a remote host.
   array<Byte>^receiveBytes = receivingUdpClient->Receive(  RemoteIpEndPoint );

   String^ returnData = Encoding::ASCII->GetString( receiveBytes );

   Console::WriteLine( "This is the message you received {0}", returnData );
   Console::WriteLine( "This message was sent from {0} on their port number {1}",
      RemoteIpEndPoint->Address, RemoteIpEndPoint->Port );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates a UdpClient for reading incoming data.
UdpClient receivingUdpClient = new UdpClient();

// Creates an IPEndPoint to record the IP Address
// and port number of the sender. 
// The IPEndPoint will allow you to 
// read datagrams sent from any source.
IPEndPoint remoteIpEndPoint = new IPEndPoint(IPAddress.Any, 0);
try {
    // Blocks until a message returns on this
    // socket from a remote host.
    ubyte receiveBytes[] = 
        receivingUdpClient.Receive(remoteIpEndPoint);
    String returnData = Encoding.get_ASCII().GetString(receiveBytes);
    Console.WriteLine(("This is the message you received " 
        + returnData.ToString()));
    Console.WriteLine(("This message was sent from " 
        + remoteIpEndPoint.get_Address().ToString() 
        + " on their port number " 
        + System.Convert.ToString(remoteIpEndPoint.get_Port())));
}
catch (System.Exception e) {
    Console.WriteLine(e.ToString());
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

UdpClient-Klasse
UdpClient-Member
System.Net.Sockets-Namespace
Send
IPEndPoint-Klasse
Connect
IPAddress-Klasse