UdpClient.Connect Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net.Sockets

Zestaw:: System.Net.Sockets.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

SocketException

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

ArgumentNullException

endPoint to null.

ObjectDisposedException

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

ObjectDisposedException

UdpClient jest zamknięty.

ArgumentNullException

addr to null.

ArgumentOutOfRangeException

port nie jest między MinPort i MaxPort.

SocketException

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 .

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.

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

ObjectDisposedException

Element UdpClient jest zamknięty.

ArgumentOutOfRangeException

port nie jest między MinPort i MaxPort.

SocketException

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 .

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.

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

UdpClient.Connect Metoda

Definicja

Przeciążenia

Connect(IPEndPoint)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Connect(IPAddress, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Connect(String, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Opinia

Dodatkowe zasoby