UdpClient.Connect Methode

Definitie

Hiermee wordt een standaard externe host ingesteld.

Overloads

Name Description
Connect(IPEndPoint)

Hiermee wordt een standaard externe host ingesteld met behulp van het opgegeven netwerkeindpunt.

Connect(IPAddress, Int32)

Hiermee wordt een standaard externe host ingesteld met behulp van het opgegeven IP-adres en poortnummer.

Connect(String, Int32)

Hiermee stelt u een standaard externe host in met behulp van de opgegeven hostnaam en poortnummer.

Connect(IPEndPoint)

Hiermee wordt een standaard externe host ingesteld met behulp van het opgegeven netwerkeindpunt.

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)

Parameters

endPoint
IPEndPoint

Een IPEndPoint die het netwerkeindpunt aangeeft waarnaar u gegevens wilt verzenden.

Uitzonderingen

Er is een fout opgetreden bij het openen van de socket.

endPoint is null.

Voorbeelden

In het volgende voorbeeld wordt een IPEndPoint standaard externe host ingesteld.

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

Opmerkingen

Met Connect de methode wordt een standaard externe host ingesteld met behulp van de waarde die is opgegeven in de endPoint parameter. Zodra de verbinding tot stand is gebracht, hoeft u geen externe host op te geven in elke aanroep naar de Send methode.

Het instellen van een standaard externe host is optioneel. Als u een standaard externe host opgeeft, beperkt u zich alleen tot die host. Als u datagrammen naar een andere externe host wilt verzenden, moet u een andere aanroep naar de Connect methode maken of een andere UdpClient maken zonder een standaard externe host. Als u een standaard externe host hebt ingesteld en u ook een externe host opgeeft in uw aanroep naar de Send methode, Send genereert u een SocketException. Als u een SocketException, gebruikt SocketException.ErrorCode om de specifieke foutcode te verkrijgen. Zodra u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.

Als u de Connect methode aanroept, worden gegevensgrammen die afkomstig zijn van een ander adres dan de opgegeven standaardwaarde verwijderd. U kunt de standaard externe host niet instellen op een broadcast-adres met behulp van deze methode, tenzij u overnemen van UdpClient, de clientmethode gebruikt om de onderliggende Sockethost te verkrijgen en de socketoptie in te stellen op SocketOptionName.Broadcast.

U kunt echter gegevens uitzenden naar het standaard broadcastadres, 255.255.255.255, als u opgeeft IPAddress.Broadcast in uw aanroep naar de Send methode. Als uw toepassing meer controle over broadcast-adressen vereist, kunt u ook terugkeren naar het gebruik van de Socket klasse.

Note

Omdat het UDP-protocol verbindingloos is, wordt de Connect methode niet geblokkeerd. Roep de Connect methode niet aan als u multicasted datagrammen wilt ontvangen.

Zie ook

Van toepassing op

Connect(IPAddress, Int32)

Hiermee wordt een standaard externe host ingesteld met behulp van het opgegeven IP-adres en poortnummer.

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)

Parameters

addr
IPAddress

De IPAddress externe host waarnaar u gegevens wilt verzenden.

port
Int32

Het poortnummer waarnaar u gegevens wilt verzenden.

Uitzonderingen

addr is null.

port is niet tussen MinPort en MaxPort.

Er is een fout opgetreden bij het openen van de socket.

Voorbeelden

In het volgende voorbeeld wordt een IP-adres en poortnummer gebruikt om verbinding te maken met een externe host.

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

Opmerkingen

Met Connect de methode wordt een standaard externe host ingesteld met behulp van de waarden die zijn opgegeven in de addr en port parameters. Zodra de verbinding tot stand is gebracht, hoeft u geen externe host op te geven in elke aanroep naar de Send methode.

Het instellen van een standaard externe host is optioneel. Als u een standaard externe host opgeeft, beperkt u zich alleen tot die host. Als u datagrammen naar een andere externe host wilt verzenden, moet u een andere aanroep naar de Connect methode maken of een andere UdpClient maken zonder een standaard externe host. Als u een standaard externe host hebt ingesteld en u ook een externe host opgeeft in uw aanroep naar de Send methode, Send genereert u een SocketException. Als u een SocketException, gebruikt SocketException.ErrorCode om de specifieke foutcode te verkrijgen. Zodra u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.

Als u de Connect methode aanroept, worden gegevensgrammen die afkomstig zijn van een ander adres dan de opgegeven standaardwaarde verwijderd. U kunt de standaard externe host niet instellen op een broadcast-adres met behulp van deze methode, tenzij u overnemen van UdpClient, de clientmethode gebruikt om de onderliggende Sockethost te verkrijgen en de socketoptie in te stellen op SocketOptionName.Broadcast.

U kunt echter gegevens uitzenden naar het standaard broadcastadres, 255.255.255.255, als u opgeeft IPAddress.Broadcast in uw aanroep naar de Send methode. Als uw toepassing meer controle over broadcast-adressen vereist, kunt u ook terugkeren naar het gebruik van de Socket klasse.

Note

Omdat het UDP-protocol verbindingloos is, wordt de Connect methode niet geblokkeerd. Roep de Connect methode niet aan als u multicasted datagrammen wilt ontvangen.

Zie ook

Van toepassing op

Connect(String, Int32)

Hiermee stelt u een standaard externe host in met behulp van de opgegeven hostnaam en poortnummer.

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)

Parameters

hostname
String

De DNS-naam van de externe host waarnaar u gegevens wilt verzenden.

port
Int32

Het poortnummer op de externe host waarnaar u gegevens wilt verzenden.

Uitzonderingen

port is niet tussen MinPort en MaxPort.

Er is een fout opgetreden bij het openen van de socket.

Voorbeelden

In het volgende voorbeeld wordt de hostnaam en het poortnummer gebruikt om verbinding te maken met een externe host.

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

Opmerkingen

Met Connect de methode wordt een standaard externe host ingesteld met behulp van de waarden die zijn opgegeven in de port en hostname parameters. Zodra de verbinding tot stand is gebracht, hoeft u geen externe host op te geven in elke aanroep naar de Send methode.

Het instellen van een standaard externe host is optioneel. Als u een standaard externe host opgeeft, beperkt u zich alleen tot die host. Als u datagrammen naar een andere externe host wilt verzenden, moet u een andere aanroep naar de Connect methode maken of een andere UdpClient maken zonder een standaard externe host.

Als u een standaard externe host hebt ingesteld en u ook een externe host opgeeft in uw aanroep naar de Send methode, Send genereert u een SocketException. Als u een SocketException, gebruikt SocketException.ErrorCode om de specifieke foutcode te verkrijgen. Zodra u deze code hebt verkregen, kunt u de Windows Sockets versie 2 API-foutcode raadplegen voor een gedetailleerde beschrijving van de fout.

Als u de Connect methode aanroept, worden gegevensgrammen die afkomstig zijn van een ander adres dan de opgegeven standaardwaarde verwijderd. U kunt de standaard externe host niet instellen op een broadcast-adres met behulp van deze methode, tenzij u overnemen van UdpClient, de clientmethode gebruikt om de onderliggende Sockethost te verkrijgen en de socketoptie in te stellen op SocketOptionName.Broadcast.

U kunt echter gegevens uitzenden naar het standaard broadcastadres, 255.255.255.255, als u opgeeft IPAddress.Broadcast in uw aanroep naar de Send methode. Als uw toepassing meer controle over broadcast-adressen vereist, kunt u ook terugkeren naar het gebruik van de Socket klasse.

Note

Omdat het UDP-protocol verbindingloos is, wordt de Connect methode niet geblokkeerd. Roep de Connect methode niet aan als u multicasted datagrammen wilt ontvangen.

Zie ook

Van toepassing op