UdpClient.Connect Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.
De UdpClient is gesloten.
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
- port
- Int32
Het poortnummer waarnaar u gegevens wilt verzenden.
Uitzonderingen
UdpClient is gesloten.
addr is null.
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
De UdpClient is gesloten.
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.