Udostępnij za pośrednictwem


UdpClient.Connect Metoda

Definicja

Ustanawia domyślnego hosta zdalnego.

Przeciążenia

Connect(IPEndPoint)

Ustanawia domyślnego hosta zdalnego przy użyciu określonego punktu końcowego sieci.

Connect(IPAddress, Int32)

Ustanawia domyślny host zdalny przy użyciu określonego adresu IP i numeru portu.

Connect(String, Int32)

Ustanawia domyślny host zdalny przy użyciu określonej nazwy hosta i numeru portu.

Connect(IPEndPoint)

Źródło:
UDPClient.cs
Źródło:
UDPClient.cs
Źródło:
UDPClient.cs

Ustanawia domyślnego hosta zdalnego przy użyciu określonego punktu końcowego sieci.

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)

Parametry

endPoint
IPEndPoint

Element IPEndPoint określający punkt końcowy sieci, do którego mają być wysyłane dane.

Wyjątki

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

endPoint to null.

Element UdpClient jest zamknięty.

Przykłady

W poniższym przykładzie użyto elementu do IPEndPoint ustanowienia domyślnego hosta zdalnego.

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

Uwagi

Metoda Connect ustanawia domyślny host zdalny przy użyciu wartości określonej w parametrze endPoint . Po ustanowieniu nie trzeba określać hosta zdalnego w każdym wywołaniu Send metody .

Ustanowienie domyślnego hosta zdalnego jest opcjonalne. Określenie domyślnego hosta zdalnego ogranicza użytkownika tylko do tego hosta. Jeśli chcesz wysłać datagramy do innego hosta zdalnego, musisz wykonać inne wywołanie Connect metody lub utworzyć inny UdpClient bez domyślnego hosta zdalnego. Jeśli ustanowiono domyślny host zdalny, a także host zdalny w wywołaniu Send metody , Send zgłosi błąd SocketException. Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

W przypadku wywołania Connect metody wszelkie datagramy przychodzące z adresu innego niż określona wartość domyślna zostaną odrzucone. Nie można ustawić domyślnego hosta zdalnego na adres emisji przy użyciu tej metody, chyba że dziedziczysz z UdpClientmetody , użyj metody client, aby uzyskać bazowe Socket, i ustaw opcję gniazda na SocketOptionName.Broadcast.

Można jednak emitować dane do domyślnego adresu emisji, 255.255.255.255, jeśli zostanie określone IPAddress.Broadcast w wywołaniu Send metody . Jeśli aplikacja wymaga większej kontroli nad adresami emisji, możesz również przywrócić klasę Socket .

Uwaga

Ponieważ protokół UDP jest bez połączenia, Connect metoda nie blokuje. Nie należy wywoływać Connect metody , jeśli zamierzasz odbierać multiemisji datagramy.

Zobacz też

Dotyczy

Connect(IPAddress, Int32)

Źródło:
UDPClient.cs
Źródło:
UDPClient.cs
Źródło:
UDPClient.cs

Ustanawia domyślny host zdalny przy użyciu określonego adresu IP i numeru portu.

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)

Parametry

addr
IPAddress

Host IPAddress zdalny, do którego mają być wysyłane dane.

port
Int32

Numer portu, do którego mają być wysyłane dane.

Wyjątki

addr to null.

port nie jest między MinPort i MaxPort.

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

W poniższym przykładzie użyto adresu IP i numeru portu do nawiązania połączenia z hostem zdalnym.

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

Uwagi

Metoda Connect ustanawia domyślny host zdalny przy użyciu wartości określonych w parametrach addr i port . Po ustanowieniu nie trzeba określać hosta zdalnego w każdym wywołaniu Send metody .

Ustanowienie domyślnego hosta zdalnego jest opcjonalne. Określenie domyślnego hosta zdalnego ogranicza użytkownika tylko do tego hosta. Jeśli chcesz wysłać datagramy do innego hosta zdalnego, musisz wykonać inne wywołanie Connect metody lub utworzyć inny UdpClient bez domyślnego hosta zdalnego. Jeśli ustanowiono domyślny host zdalny, a także host zdalny w wywołaniu Send metody , Send zgłosi błąd SocketException. Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

W przypadku wywołania Connect metody wszelkie datagramy przychodzące z adresu innego niż określona wartość domyślna zostaną odrzucone. Nie można ustawić domyślnego hosta zdalnego na adres emisji przy użyciu tej metody, chyba że dziedziczysz z UdpClientmetody , użyj metody klienta, aby uzyskać bazowe Socket, i ustaw opcję gniazda na SocketOptionName.Broadcast.

Można jednak emitować dane do domyślnego adresu emisji, 255.255.255.255, jeśli zostanie określone IPAddress.Broadcast w wywołaniu Send metody . Jeśli aplikacja wymaga większej kontroli nad adresami emisji, możesz również przywrócić klasę Socket .

Uwaga

Ponieważ protokół UDP jest bez połączenia, Connect metoda nie blokuje. Nie należy wywoływać Connect metody , jeśli zamierzasz odbierać multiemisji datagramy.

Zobacz też

Dotyczy

Connect(String, Int32)

Źródło:
UDPClient.cs
Źródło:
UDPClient.cs
Źródło:
UDPClient.cs

Ustanawia domyślny host zdalny przy użyciu określonej nazwy hosta i numeru portu.

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)

Parametry

hostname
String

Nazwa DNS hosta zdalnego, do którego mają być wysyłane dane.

port
Int32

Numer portu na hoście zdalnym, do którego mają być wysyłane dane.

Wyjątki

Element UdpClient jest zamknięty.

port nie jest między MinPort i MaxPort.

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

W poniższym przykładzie użyto nazwy hosta i numeru portu do nawiązania połączenia z hostem zdalnym.

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

Uwagi

Metoda Connect ustanawia domyślny host zdalny przy użyciu wartości określonych w parametrach port i hostname . Po ustanowieniu nie trzeba określać hosta zdalnego w każdym wywołaniu Send metody .

Ustanowienie domyślnego hosta zdalnego jest opcjonalne. Określenie domyślnego hosta zdalnego ogranicza użytkownika tylko do tego hosta. Jeśli chcesz wysłać datagramy do innego hosta zdalnego, musisz wykonać inne wywołanie Connect metody lub utworzyć inny UdpClient bez domyślnego hosta zdalnego.

Jeśli ustanowiono domyślny host zdalny, a także host zdalny w wywołaniu Send metody , Send zgłosi błąd SocketException. Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

W przypadku wywołania Connect metody wszelkie datagramy przychodzące z adresu innego niż określona wartość domyślna zostaną odrzucone. Nie można ustawić domyślnego hosta zdalnego na adres emisji przy użyciu tej metody, chyba że dziedziczysz z UdpClientmetody , użyj metody klienta, aby uzyskać bazowe Socket, i ustaw opcję gniazda na SocketOptionName.Broadcast.

Można jednak emitować dane do domyślnego adresu emisji, 255.255.255.255, jeśli zostanie określone IPAddress.Broadcast w wywołaniu Send metody . Jeśli aplikacja wymaga większej kontroli nad adresami emisji, możesz również przywrócić klasę Socket .

Uwaga

Ponieważ protokół UDP jest bez połączenia, Connect metoda nie blokuje. Nie należy wywoływać Connect metody , jeśli zamierzasz odbierać multiemisji datagramy.

Zobacz też

Dotyczy