UdpClient.Connect Metod

Definition

Upprättar en standardvärd för fjärranslutning.

Överlagringar

Name Description
Connect(IPEndPoint)

Upprättar en standardvärd med hjälp av den angivna nätverksslutpunkten.

Connect(IPAddress, Int32)

Upprättar en standardvärd med den angivna IP-adressen och portnumret.

Connect(String, Int32)

Upprättar en standardvärd med det angivna värdnamnet och portnumret.

Connect(IPEndPoint)

Upprättar en standardvärd med hjälp av den angivna nätverksslutpunkten.

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)

Parametrar

endPoint
IPEndPoint

En IPEndPoint som anger den nätverksslutpunkt som du tänker skicka data till.

Undantag

Ett fel uppstod vid åtkomst till socketen.

endPoint är null.

Exempel

I följande exempel används en IPEndPoint för att upprätta en standardvärd för fjärranslutning.

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

Kommentarer

Metoden Connect etablerar en fjärrvärd med standardvärdet som anges i parametern endPoint . När du har upprättat behöver du inte ange en fjärrvärd i varje anrop till Send metoden.

Det är valfritt att upprätta en standardvärd för fjärranslutningen. Om du anger en fjärrvärd som standard begränsas du endast till den värden. Om du vill skicka datagram till en annan fjärrvärd måste du göra ett nytt anrop till Connect metoden eller skapa ett annat UdpClient utan en standardvärd. Om du har upprättat en standardvärd för fjärranslutningen och du även anger en fjärrvärd i anropet Send till -metoden, Send utlöser du en SocketException. Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 API för en detaljerad beskrivning av felet.

Om du anropar Connect metoden ignoreras alla datagram som kommer från en annan adress än den angivna standardinställningen. Du kan inte ange standardvärden för en broadcast-adress med den här metoden om du inte ärver från UdpClient, använder metoden Klient för att hämta den underliggande Socketoch anger socketalternativet till SocketOptionName.Broadcast.

Du kan dock sända data till standardadressen för sändning, 255.255.255.255, om du anger IPAddress.Broadcast i anropet Send till metoden. Om programmet kräver större kontroll över sändningsadresser kan du också återgå till att använda Socket klassen.

Note

Eftersom UDP-protokollet är anslutningslöst blockeras Connect inte metoden. Anropa Connect inte metoden om du tänker ta emot multicastade datagram.

Se även

Gäller för

Connect(IPAddress, Int32)

Upprättar en standardvärd med den angivna IP-adressen och portnumret.

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)

Parametrar

addr
IPAddress

Den IPAddress fjärrvärd som du tänker skicka data till.

port
Int32

Det portnummer som du tänker skicka data till.

Undantag

addr är null.

port är inte mellan MinPort och MaxPort.

Ett fel uppstod vid åtkomst till socketen.

Exempel

I följande exempel används en IP-adress och ett portnummer för att ansluta till en fjärrvärd.

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

Kommentarer

Metoden Connect etablerar en standardvärd med hjälp av de värden som anges i parametrarna addr och port . När du har upprättat behöver du inte ange en fjärrvärd i varje anrop till Send metoden.

Det är valfritt att upprätta en standardvärd för fjärranslutningen. Om du anger en fjärrvärd som standard begränsas du endast till den värden. Om du vill skicka datagram till en annan fjärrvärd måste du göra ett nytt anrop till Connect metoden eller skapa ett annat UdpClient utan en standardvärd. Om du har upprättat en standardvärd för fjärranslutningen och du även anger en fjärrvärd i anropet Send till -metoden, Send utlöser du en SocketException. Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 API för en detaljerad beskrivning av felet.

Om du anropar Connect metoden ignoreras alla datagram som kommer från en annan adress än den angivna standardinställningen. Du kan inte ange standardvärden för en sändningsadress med den här metoden om du inte ärver från UdpClient, använder klientmetoden för att hämta den underliggande Socketoch ställer in socketalternativet på SocketOptionName.Broadcast.

Du kan dock sända data till standardadressen för sändning, 255.255.255.255, om du anger IPAddress.Broadcast i anropet Send till metoden. Om programmet kräver större kontroll över sändningsadresser kan du också återgå till att använda Socket klassen.

Note

Eftersom UDP-protokollet är anslutningslöst blockeras Connect inte metoden. Anropa Connect inte metoden om du tänker ta emot multicastade datagram.

Se även

Gäller för

Connect(String, Int32)

Upprättar en standardvärd med det angivna värdnamnet och portnumret.

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)

Parametrar

hostname
String

DNS-namnet på fjärrvärden som du tänker skicka data till.

port
Int32

Portnumret på fjärrvärden som du tänker skicka data till.

Undantag

port är inte mellan MinPort och MaxPort.

Ett fel uppstod vid åtkomst till socketen.

Exempel

I följande exempel används värdnamnet och portnumret för att ansluta till en fjärrvärd.

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

Kommentarer

Metoden Connect etablerar en standardvärd med hjälp av de värden som anges i parametrarna port och hostname . När du har upprättat behöver du inte ange en fjärrvärd i varje anrop till Send metoden.

Det är valfritt att upprätta en standardvärd för fjärranslutningen. Om du anger en fjärrvärd som standard begränsas du endast till den värden. Om du vill skicka datagram till en annan fjärrvärd måste du göra ett nytt anrop till Connect metoden eller skapa ett annat UdpClient utan en standardvärd.

Om du har upprättat en standardvärd för fjärranslutningen och du även anger en fjärrvärd i anropet Send till -metoden, Send utlöser du en SocketException. Om du får en SocketExceptionanvänder SocketException.ErrorCode du för att hämta den specifika felkoden. När du har fått den här koden kan du läsa felkoden Windows Sockets version 2 API för en detaljerad beskrivning av felet.

Om du anropar Connect metoden ignoreras alla datagram som kommer från en annan adress än den angivna standardinställningen. Du kan inte ange standardvärden för en sändningsadress med den här metoden om du inte ärver från UdpClient, använder klientmetoden för att hämta den underliggande Socketoch ställer in socketalternativet på SocketOptionName.Broadcast.

Du kan dock sända data till standardadressen för sändning, 255.255.255.255, om du anger IPAddress.Broadcast i anropet Send till metoden. Om programmet kräver större kontroll över sändningsadresser kan du också återgå till att använda Socket klassen.

Note

Eftersom UDP-protokollet är anslutningslöst blockeras Connect inte metoden. Anropa Connect inte metoden om du tänker ta emot multicastade datagram.

Se även

Gäller för