Freigeben über

UdpClient.Connect Methode

  • Referenz

Definition

Namespace:
System.Net.Sockets
Assembly:
System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Richtet einen Standardremotehost ein.

Überlädt

Connect(IPEndPoint)

Richtet mit dem angegebenen Netzwerkendpunkt einen Standardremotehost ein.
Connect(IPAddress, Int32)

Richtet einen Standardremotehost mithilfe der angegebenen IP-Adresse und Anschlussnummer ein.
Connect(String, Int32)

Richtet einen Standardremotehost mit dem angegebenen Hostnamen und der Anschlussnummer ein.

Connect(IPEndPoint)

Quelle:
UDPClient.cs
Quelle:
UDPClient.cs
Quelle:
UDPClient.cs

Richtet mit dem angegebenen Netzwerkendpunkt einen Standardremotehost ein.

public:
 void Connect(System::Net::IPEndPoint ^ endPoint);
public void Connect (System.Net.IPEndPoint endPoint);
member this.Connect : System.Net.IPEndPoint -> unit
Public Sub Connect (endPoint As IPEndPoint)

Parameter

endPoint
IPEndPoint

Ein IPEndPoint, der den Netzwerkendpunkt angibt, an den Daten gesendet werden sollen.

Ausnahmen

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

ArgumentNullException

endPoint ist null.

ObjectDisposedException

Der UdpClient ist geschlossen.

Beispiele

Im folgenden Beispiel wird ein IPEndPoint verwendet, um einen Standard-Remotehost einzurichten.

//Uses a remote endpoint to establish a socket connection.
UdpClient^ udpClient = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
try
{
   udpClient->Connect( ipEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Uses a remote endpoint to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);
try{
 udpClient.Connect(ipEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

'Uses a remote endpoint to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)
Try
   udpClient.Connect(ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Hinweise

Die Connect -Methode erstellt einen Standard-Remotehost unter Verwendung des im endPoint -Parameter angegebenen Werts. Nach der Einrichtung müssen Sie keinen Remotehost in jedem Aufruf der Send -Methode angeben.

Das Einrichten eines Standard-Remotehosts ist optional. Die Angabe eines Standard-Remotehosts beschränkt Sie nur auf diesen Host. Wenn Sie Datagramme an einen anderen Remotehost senden möchten, müssen Sie einen weiteren Aufruf der Connect -Methode durchführen oder einen anderen UdpClient ohne Standard-Remotehost erstellen. Wenn Sie einen Standard-Remotehost eingerichtet haben und in Ihrem Aufruf der Send -Methode auch einen Remotehost angeben, Send löst eine aus SocketException. Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Wenn Sie die Connect -Methode aufrufen, werden alle Datagramme verworfen, die von einer anderen Adresse als der angegebenen Standardadresse empfangen werden. Sie können den Standard-Remotehost mit dieser Methode nicht auf eine Broadcastadresse festlegen, es sei denn, Sie erben von UdpClient, verwenden Sie die Clientmethode, um die zugrunde liegende Socketabzurufen, und legen Sie die Socketoption auf fest SocketOptionName.Broadcast.

Sie können daten jedoch an die Standard-Broadcastadresse 255.255.255.255 übertragen, wenn Sie in Ihrem Aufruf der Send -Methode angebenIPAddress.Broadcast. Wenn Ihre Anwendung eine bessere Kontrolle über Broadcastadressen erfordert, können Sie auch rückgängig machen, die Socket -Klasse zu verwenden.

Hinweis

Da das UDP-Protokoll verbindungslos ist, wird die Connect -Methode nicht blockiert. Rufen Sie die Connect -Methode nicht auf, wenn Sie multicastierte Datagramme empfangen möchten.

Weitere Informationen

Gilt für:

Connect(IPAddress, Int32)

Quelle:
UDPClient.cs
Quelle:
UDPClient.cs
Quelle:
UDPClient.cs

Richtet einen Standardremotehost mithilfe der angegebenen IP-Adresse und Anschlussnummer ein.

public:
 void Connect(System::Net::IPAddress ^ addr, int port);
public void Connect (System.Net.IPAddress addr, int port);
member this.Connect : System.Net.IPAddress * int -> unit
Public Sub Connect (addr As IPAddress, port As Integer)

Parameter

addr
IPAddress

Die IPAddress des Remotehosts, an die Daten gesendet werden sollen.

port
Int32

Die Anschlussnummer, an die Daten gesendet werden sollen.

Ausnahmen

ObjectDisposedException

Der UdpClient ist geschlossen.

ArgumentNullException

addr ist null.

ArgumentOutOfRangeException

port liegt nicht zwischen MinPort und MaxPort.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

Beispiele

Im folgenden Beispiel werden eine IP-Adresse und eine Portnummer verwendet, um eine Verbindung mit einem Remotehost herzustellen.

//Uses the IP address and port number to establish a socket connection.
UdpClient^ udpClient = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
try
{
   udpClient->Connect( ipAddress, 11003 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Uses the IP address and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
try{
    udpClient.Connect(ipAddress, 11003);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Uses the IP address and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Try
   udpClient.Connect(ipAddress, 11003)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Hinweise

Die Connect -Methode erstellt einen Standard-Remotehost mit den werten, die in den addr Parametern und port angegeben sind. Nach der Einrichtung müssen Sie keinen Remotehost in jedem Aufruf der Send -Methode angeben.

Das Einrichten eines Standard-Remotehosts ist optional. Die Angabe eines Standard-Remotehosts beschränkt Sie nur auf diesen Host. Wenn Sie Datagramme an einen anderen Remotehost senden möchten, müssen Sie einen weiteren Aufruf der Connect -Methode durchführen oder einen anderen UdpClient ohne Standard-Remotehost erstellen. Wenn Sie einen Standard-Remotehost eingerichtet haben und in Ihrem Aufruf der Send -Methode auch einen Remotehost angeben, Send löst eine aus SocketException. Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Wenn Sie die Connect -Methode aufrufen, werden alle Datagramme verworfen, die von einer anderen Adresse als der angegebenen Standardadresse empfangen werden. Sie können den Standard-Remotehost mit dieser Methode nicht auf eine Broadcastadresse festlegen, es sei denn, Sie erben von UdpClient, verwenden Sie die Clientmethode, um die zugrunde liegende Socketabzurufen, und legen Sie die Socketoption auf fest SocketOptionName.Broadcast.

Sie können daten jedoch an die Standard-Broadcastadresse 255.255.255.255 übertragen, wenn Sie in Ihrem Aufruf der Send -Methode angebenIPAddress.Broadcast. Wenn Ihre Anwendung eine bessere Kontrolle über Broadcastadressen erfordert, können Sie auch rückgängig machen, die Socket -Klasse zu verwenden.

Hinweis

Da das UDP-Protokoll verbindungslos ist, wird die Connect -Methode nicht blockiert. Rufen Sie die Connect -Methode nicht auf, wenn Sie multicastierte Datagramme empfangen möchten.

Weitere Informationen

Gilt für:

Connect(String, Int32)

Quelle:
UDPClient.cs
Quelle:
UDPClient.cs
Quelle:
UDPClient.cs

Richtet einen Standardremotehost mit dem angegebenen Hostnamen und der Anschlussnummer ein.

public:
 void Connect(System::String ^ hostname, int port);
public void Connect (string hostname, int port);
member this.Connect : string * int -> unit
Public Sub Connect (hostname As String, port As Integer)

Parameter

hostname
String

Der DNS-Name des Remotehosts, an den Daten gesendet werden sollen.

port
Int32

Die Anschlussnummer auf dem Remotehost, an den Daten gesendet werden sollen.

Ausnahmen

ObjectDisposedException

Der UdpClient ist geschlossen.

ArgumentOutOfRangeException

port liegt nicht zwischen MinPort und MaxPort.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

Beispiele

Im folgenden Beispiel werden der Hostname und die Portnummer verwendet, um eine Verbindung mit einem Remotehost herzustellen.

//Uses a host name and port number to establish a socket connection.
UdpClient^ udpClient = gcnew UdpClient;
try
{
   udpClient->Connect( "www.contoso.com", 11002 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

 //Uses a host name and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
try{
    udpClient.Connect("www.contoso.com", 11002);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

'Uses a host name and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Try
   udpClient.Connect("www.contoso.com", 11002)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Hinweise

Die Connect -Methode erstellt einen Standard-Remotehost mit den werten, die in den port Parametern und hostname angegeben sind. Nach der Einrichtung müssen Sie keinen Remotehost in jedem Aufruf der Send -Methode angeben.

Das Einrichten eines Standard-Remotehosts ist optional. Die Angabe eines Standard-Remotehosts beschränkt Sie nur auf diesen Host. Wenn Sie Datagramme an einen anderen Remotehost senden möchten, müssen Sie einen weiteren Aufruf der Connect -Methode durchführen oder einen anderen UdpClient ohne Standard-Remotehost erstellen.

Wenn Sie einen Standard-Remotehost eingerichtet haben und in Ihrem Aufruf der Send -Methode auch einen Remotehost angeben, Send löst eine aus SocketException. Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Wenn Sie die Connect -Methode aufrufen, werden alle Datagramme verworfen, die von einer anderen Adresse als der angegebenen Standardadresse empfangen werden. Sie können den Standard-Remotehost mit dieser Methode nicht auf eine Broadcastadresse festlegen, es sei denn, Sie erben von UdpClient, verwenden Sie die Clientmethode, um die zugrunde liegende Socketabzurufen, und legen Sie die Socketoption auf fest SocketOptionName.Broadcast.

Sie können daten jedoch an die Standard-Broadcastadresse 255.255.255.255 übertragen, wenn Sie in Ihrem Aufruf der Send -Methode angebenIPAddress.Broadcast. Wenn Ihre Anwendung eine bessere Kontrolle über Broadcastadressen erfordert, können Sie auch rückgängig machen, die Socket -Klasse zu verwenden.

Hinweis

Da das UDP-Protokoll verbindungslos ist, wird die Connect -Methode nicht blockiert. Rufen Sie die Connect -Methode nicht auf, wenn Sie multicastierte Datagramme empfangen möchten.

Weitere Informationen

Gilt für: