Freigeben über


UdpClient-Konstruktor (String, Int32)

Initialisiert eine neue Instanz der UdpClient-Klasse und richtet einen Standardremotehost ein.

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

Syntax

'Declaration
Public Sub New ( _
    hostname As String, _
    port As Integer _
)
'Usage
Dim hostname As String
Dim port As Integer

Dim instance As New UdpClient(hostname, port)
public UdpClient (
    string hostname,
    int port
)
public:
UdpClient (
    String^ hostname, 
    int port
)
public UdpClient (
    String hostname, 
    int port
)
public function UdpClient (
    hostname : String, 
    port : int
)

Parameter

  • hostname
    Der Name des Remote-DNS-Hosts, zu dem die Verbindung hergestellt werden soll.
  • port
    Die Nummer des Remoteanschlusses, mit dem die Verbindung hergestellt werden soll.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

hostname ist NULL (Nothing in Visual Basic).

ArgumentOutOfRangeException

port liegt nicht zwischen MinPort und MaxPort.

SocketException

Fehler beim Zugriff auf den Socket. Weitere Informationen finden Sie im Abschnitt "Hinweise".

Hinweise

Dieser Konstruktor initialisiert einen neuen UdpClient und richtet über den hostname-Parameter und den port-Parameter einen Remotehost ein. Das Einrichten eines Standardremotehosts ist optional. Bei der Verwendung dieses Konstruktors müssen Sie nicht bei jedem Aufruf der Send-Methode einen Remotehost angeben. Wenn Sie einen Standardremotehost angeben, können Sie auch nur diesen Host verwenden. Sie können den Standardremotehost jederzeit ändern, indem Sie die Connect-Methode aufrufen. Verwenden Sie diesen Konstruktor nicht, wenn Sie beim Aufruf der Send-Methode einen Remotehost angeben möchten.

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 die Verwendung eines Hostnamens und einer Anschlussnummer beim Erstellen einer Instanz der UdpClient-Klasse veranschaulicht.

'Creates an instance of the UdpClient class with a remote host name and a port number.
Try
   Dim udpClient As New UdpClient("www.contoso.com", 11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try
//Creates an instance of the UdpClient class with a remote host name and a port number.
try{
     UdpClient udpClient = new UdpClient("www.contoso.com",11000);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}
//Creates an instance of the UdpClient class with a remote host name and a port number.
try
{
   UdpClient^ udpClient = gcnew UdpClient( "www.contoso.com",11000 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}
    // Creates an instance of the UdpClient class 
    // with a remote host name and a port number.
    try {
        UdpClient udpClient = 
            new UdpClient("www.contoso.com", 11000);
    }
    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
Connect