UdpClient.Connect UdpClient.Connect UdpClient.Connect UdpClient.Connect Method

Definition

Richtet einen Standardremotehost ein.Establishes a default remote host.

Überlädt

Connect(IPEndPoint) Connect(IPEndPoint) Connect(IPEndPoint) Connect(IPEndPoint)

Richtet mit dem angegebenen Netzwerkendpunkt einen Standardremotehost ein.Establishes a default remote host using the specified network endpoint.

Connect(IPAddress, Int32) Connect(IPAddress, Int32) Connect(IPAddress, Int32) Connect(IPAddress, Int32)

Richtet einen Standardremotehost mithilfe der angegebenen IP-Adresse und Anschlussnummer ein.Establishes a default remote host using the specified IP address and port number.

Connect(String, Int32) Connect(String, Int32) Connect(String, Int32) Connect(String, Int32)

Richtet einen Standardremotehost mit dem angegebenen Hostnamen und der Anschlussnummer ein.Establishes a default remote host using the specified host name and port number.

Connect(IPEndPoint) Connect(IPEndPoint) Connect(IPEndPoint) Connect(IPEndPoint)

Richtet mit dem angegebenen Netzwerkendpunkt einen Standardremotehost ein.Establishes a default remote host using the specified network endpoint.

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 IPEndPoint IPEndPoint IPEndPoint

Ein IPEndPoint, der den Netzwerkendpunkt angibt, an den Daten gesendet werden sollen.An IPEndPoint that specifies the network endpoint to which you intend to send data.

Ausnahmen

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.An error occurred when accessing the socket.

Beispiele

Im folgenden Beispiel wird ein IPEndPoint einen Standard-Remotehost herstellen.The following example uses an IPEndPoint to establish a default remote host.

//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 richtet einen Standardremotehost mit dem angegeben wird, der endPoint Parameter.The Connect method establishes a default remote host using the value specified in the endPoint parameter. Nach dem einrichten, müssen Sie nicht in jedem Aufruf an einen Remotehost angeben der Send Methode.Once established, you do not have to specify a remote host in each call to the Send method.

Einrichten einen Standard-Remotehost ist optional.Establishing a default remote host is optional. Angeben einen Standard-Remotehost beschränkt für diesen Host nur.Specifying a default remote host limits you to that host only. Wenn Sie Datagramme zu einem anderen Host für die remote senden möchten, müssen Sie einen anderen Aufruf, der Connect Methode aus, oder erstellen Sie einen anderen UdpClient ohne einen Standardremotehost ein.If you want to send datagrams to a different remote host, you must make another call to the Connect method or create another UdpClient without a default remote host. Wenn Sie eine eingerichtet wurde Host, und Sie auch bereitstellen einen remoter Host im Aufruf an die Send -Methode, Send löst eine SocketException.If you have established a default remote host and you also provide a remote host in your call to the Send method, Send will throw a SocketException. Wenn Sie erhalten eine SocketException, verwenden Sie SocketException.ErrorCode um den spezifischen Fehlercode abzurufen.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. Wenn Sie diesen Code abgerufen haben, sehen Sie sich die Windows Sockets-Version 2-API-Fehlercode Dokumentation für eine ausführliche Beschreibung des Fehlers.Once you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Wenn Sie beim Aufrufen der Connect -Methode, alle Datagramme, die von einer eingehen, anders als der angegebene Standardwert werden verworfen.If you call the Connect method, any datagrams that arrive from an address other than the specified default will be discarded. Kann nicht festgelegt werden auf eine Broadcastadresse, die mit dieser Methode aus, es sei denn, Sie erben die Standard-Remotehost UdpClient, verwenden Sie die Client-Methode zum Abrufen der zugrunde liegende Socket, und legen Sie die Socketoption auf SocketOptionName.Broadcast.You cannot set the default remote host to a broadcast address using this method unless you inherit from UdpClient, use the Client method to obtain the underlying Socket, and set the socket option to SocketOptionName.Broadcast.

Sie können jedoch, Daten auf den Standardwert Broadcastadresse, 255.255.255.255, bei Angabe von IPAddress.Broadcast im Aufruf an die Send Methode.You can however, broadcast data to the default broadcast address, 255.255.255.255, if you specify IPAddress.Broadcast in your call to the Send method. Wenn Ihre Anwendung mehr Kontrolle über die broadcast-Adressen erfordert, können Sie auch Wiederherstellen mit der Socket Klasse.If your application requires greater control over broadcast addresses, you can also revert to using the Socket class.

Hinweis

Da das UDP-Protokoll verbindungslose, ist die Connect Methode wird nicht blockiert.Since the UDP protocol is connectionless, the Connect method does not block. Rufen Sie nicht die Connect Methode, wenn Sie beabsichtigen, Multicastdatagramme empfangen.Do not call the Connect method if you intend to receive multicasted datagrams.

Siehe auch

Connect(IPAddress, Int32) Connect(IPAddress, Int32) Connect(IPAddress, Int32) Connect(IPAddress, Int32)

Richtet einen Standardremotehost mithilfe der angegebenen IP-Adresse und Anschlussnummer ein.Establishes a default remote host using the specified IP address and port number.

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 IPAddress IPAddress IPAddress

Die IPAddress des Remotehosts, an die Daten gesendet werden sollen.The IPAddress of the remote host to which you intend to send data.

port
Int32 Int32 Int32 Int32

Die Anschlussnummer, an die Daten gesendet werden sollen.The port number to which you intend send data.

Ausnahmen

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.An error occurred when accessing the socket.

Beispiele

Im folgenden Beispiel wird eine IP-Adresse und Port-Nummer für die Verbindung mit einem Remotehost.The following example uses an IP address and port number to connect with a remote host.

//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 richtet einen Standardremotehost mithilfe der Werte im angegebenen die addr und port Parameter.The Connect method establishes a default remote host using the values specified in the addr and port parameters. Nach dem einrichten, müssen Sie nicht in jedem Aufruf an einen Remotehost angeben der Send Methode.Once established, you do not have to specify a remote host in each call to the Send method.

Einrichten einen Standard-Remotehost ist optional.Establishing a default remote host is optional. Angeben einen Standard-Remotehost beschränkt für diesen Host nur.Specifying a default remote host limits you to that host only. Wenn Sie Datagramme zu einem anderen Host für die remote senden möchten, müssen Sie einen anderen Aufruf, der Connect Methode aus, oder erstellen Sie einen anderen UdpClient ohne einen Standardremotehost ein.If you want to send datagrams to a different remote host, you must make another call to the Connect method or create another UdpClient without a default remote host. Wenn Sie eine eingerichtet wurde Host, und Sie auch bereitstellen einen remoter Host im Aufruf an die Send -Methode, Send löst eine SocketException.If you have established a default remote host and you also provide a remote host in your call to the Send method, Send will throw a SocketException. Wenn Sie erhalten eine SocketException, verwenden Sie SocketException.ErrorCode um den spezifischen Fehlercode abzurufen.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. Wenn Sie diesen Code abgerufen haben, sehen Sie sich die Windows Sockets-Version 2-API-Fehlercode Dokumentation für eine ausführliche Beschreibung des Fehlers.Once you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Wenn Sie beim Aufrufen der Connect -Methode, alle Datagramme, die von einer eingehen, anders als der angegebene Standardwert werden verworfen.If you call the Connect method, any datagrams that arrive from an address other than the specified default will be discarded. Kann nicht festgelegt werden auf eine Broadcastadresse, die mit dieser Methode aus, es sei denn, Sie erben die Standard-Remotehost UdpClient, verwenden Sie die Clientmethode zum Abrufen der zugrunde liegende Socket, und legen Sie die Socketoption auf SocketOptionName.Broadcast.You cannot set the default remote host to a broadcast address using this method unless you inherit from UdpClient, use the client method to obtain the underlying Socket, and set the socket option to SocketOptionName.Broadcast.

Sie können jedoch, Daten auf den Standardwert Broadcastadresse, 255.255.255.255, bei Angabe von IPAddress.Broadcast im Aufruf an die Send Methode.You can however, broadcast data to the default broadcast address, 255.255.255.255, if you specify IPAddress.Broadcast in your call to the Send method. Wenn Ihre Anwendung mehr Kontrolle über die broadcast-Adressen erfordert, können Sie auch Wiederherstellen mit der Socket Klasse.If your application requires greater control over broadcast addresses, you can also revert to using the Socket class.

Hinweis

Da das UDP-Protokoll verbindungslose, ist die Connect Methode wird nicht blockiert.Since the UDP protocol is connectionless, the Connect method does not block. Rufen Sie nicht die Connect Methode, wenn Sie beabsichtigen, Multicastdatagramme empfangen.Do not call the Connect method if you intend to receive multicasted datagrams.

Siehe auch

Connect(String, Int32) Connect(String, Int32) Connect(String, Int32) Connect(String, Int32)

Richtet einen Standardremotehost mit dem angegebenen Hostnamen und der Anschlussnummer ein.Establishes a default remote host using the specified host name and port number.

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 String String String

Der DNS-Name des Remotehosts, an den Daten gesendet werden sollen.The DNS name of the remote host to which you intend send data.

port
Int32 Int32 Int32 Int32

Die Anschlussnummer auf dem Remotehost, an den Daten gesendet werden sollen.The port number on the remote host to which you intend to send data.

Ausnahmen

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.An error occurred when accessing the socket.

Beispiele

Im folgenden Beispiel wird der Hostname und die Portnummer an, für die Verbindung mit einem Remotehost verwendet.The following example uses the host name and port number to connect to a remote host.

//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 richtet einen Standardremotehost mithilfe der Werte im angegebenen die port und hostname Parameter.The Connect method establishes a default remote host using the values specified in the port and hostname parameters. Nach dem einrichten, müssen Sie nicht in jedem Aufruf an einen Remotehost angeben der Send Methode.Once established, you do not have to specify a remote host in each call to the Send method.

Einrichten einen Standard-Remotehost ist optional.Establishing a default remote host is optional. Angeben einen Standard-Remotehost beschränkt für diesen Host nur.Specifying a default remote host limits you to that host only. Wenn Sie Datagramme zu einem anderen Host für die remote senden möchten, müssen Sie einen anderen Aufruf, der Connect Methode aus, oder erstellen Sie einen anderen UdpClient ohne einen Standardremotehost ein.If you want to send datagrams to a different remote host, you must make another call to the Connect method or create another UdpClient without a default remote host.

Wenn Sie eine eingerichtet wurde Host, und Sie auch bereitstellen einen remoter Host im Aufruf an die Send -Methode, Send löst eine SocketException.If you have established a default remote host and you also provide a remote host in your call to the Send method, Send will throw a SocketException. Wenn Sie erhalten eine SocketException, verwenden Sie SocketException.ErrorCode um den spezifischen Fehlercode abzurufen.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. Wenn Sie diesen Code abgerufen haben, sehen Sie sich die Windows Sockets-Version 2-API-Fehlercode Dokumentation für eine ausführliche Beschreibung des Fehlers.Once you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Wenn Sie beim Aufrufen der Connect -Methode, alle Datagramme, die von einer eingehen, anders als der angegebene Standardwert werden verworfen.If you call the Connect method, any datagrams that arrive from an address other than the specified default will be discarded. Kann nicht festgelegt werden auf eine Broadcastadresse, die mit dieser Methode aus, es sei denn, Sie erben die Standard-Remotehost UdpClient, verwenden Sie die Clientmethode zum Abrufen der zugrunde liegende Socket, und legen Sie die Socketoption auf SocketOptionName.Broadcast.You cannot set the default remote host to a broadcast address using this method unless you inherit from UdpClient, use the client method to obtain the underlying Socket, and set the socket option to SocketOptionName.Broadcast.

Sie können jedoch, Daten auf den Standardwert Broadcastadresse, 255.255.255.255, bei Angabe von IPAddress.Broadcast im Aufruf an die Send Methode.You can however, broadcast data to the default broadcast address, 255.255.255.255, if you specify IPAddress.Broadcast in your call to the Send method. Wenn Ihre Anwendung mehr Kontrolle über die broadcast-Adressen erfordert, können Sie auch Wiederherstellen mit der Socket Klasse.If your application requires greater control over broadcast addresses, you can also revert to using the Socket class.

Hinweis

Da das UDP-Protokoll verbindungslose, ist die Connect Methode wird nicht blockiert.Since the UDP protocol is connectionless, the Connect method does not block. Rufen Sie nicht die Connect Methode, wenn Sie beabsichtigen, Multicastdatagramme empfangen.Do not call the Connect method if you intend to receive multicasted datagrams.

Siehe auch

Gilt für: