UdpClient-Konstruktor (IPEndPoint)

Initialisiert eine neue Instanz der UdpClient-Klasse und bindet sie an den angegebenen lokalen Endpunkt.

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

Syntax

'Declaration
Public Sub New ( _
    localEP As IPEndPoint _
)
'Usage
Dim localEP As IPEndPoint

Dim instance As New UdpClient(localEP)

public UdpClient (
    IPEndPoint localEP
)

public:
UdpClient (
    IPEndPoint^ localEP
)

public UdpClient (
    IPEndPoint localEP
)

public function UdpClient (
    localEP : IPEndPoint
)

Parameter

• localEP
  Ein IPEndPoint, der den lokalen Endpunkt darstellt, an den Sie die UDP-Verbindung binden.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	localEP ist NULL (Nothing in Visual Basic).
SocketException	Fehler beim Zugriff auf den Socket. Weitere Informationen finden Sie im Abschnitt "Hinweise".

Hinweise

Dieser Konstruktor erstellt einen neuen UdpClient und bindet ihn an den im localEP-Parameter angegebenen IPEndPoint. Vor dem Aufruf dieses Konstruktors müssen Sie unter Angabe von IP-Adresse und Anschlussnummer einen IPEndPoint erstellen, von dem Daten gesendet und empfangen werden sollen. Die Angabe einer lokalen IP-Adresse und Anschlussnummer ist zum Senden und Empfangen von Daten nicht erforderlich. Ohne Angabe weist der zugrunde liegende Dienstanbieter die am besten geeignete lokale IP-Adresse und Anschlussnummer zu.

Hinweis

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.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie mithilfe eines lokalen Endpunkts eine Instanz der UdpClient-Klasse erstellt wird.

'Creates an instance of the UdpClient class using a local endpoint.
Dim ipAddress As IPAddress = Dns.Resolve(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 11000)

Try
   Dim udpClient As New UdpClient(ipLocalEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

//Creates an instance of the UdpClient class using a local endpoint.
 IPAddress ipAddress = Dns.Resolve(Dns.GetHostName()).AddressList[0];
 IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);

try{
     UdpClient udpClient = new UdpClient(ipLocalEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

//Creates an instance of the UdpClient class using a local endpoint.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );

try
{
   UdpClient^ udpClient = gcnew UdpClient( ipLocalEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

    // Creates an instance of the UdpClient 
    // class using a local endpoint.
    IPAddress ipAddress =
        Dns.Resolve(Dns.GetHostName()).get_AddressList()[0];
    IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);
    try {
        UdpClient udpClient = new UdpClient(ipLocalEndPoint);
    }
    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
IPEndPoint-Klasse