UdpClient.Connect Metoda

Reference

Definice

Obor názvů:: System.Net.Sockets

Sestavení:: System.Net.Sockets.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří výchozího vzdáleného hostitele.

Přetížení

Connect(IPEndPoint)	Vytvoří výchozího vzdáleného hostitele pomocí zadaného koncového bodu sítě.
Connect(IPAddress, Int32)	Vytvoří výchozího vzdáleného hostitele pomocí zadané IP adresy a čísla portu.
Connect(String, Int32)	Vytvoří výchozího vzdáleného hostitele pomocí zadaného názvu hostitele a čísla portu.

Connect(IPEndPoint)

Zdroj:: UDPClient.cs

Zdroj:: UDPClient.cs

Zdroj:: UDPClient.cs

Vytvoří výchozího vzdáleného hostitele pomocí zadaného koncového bodu sítě.

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

Určuje IPEndPoint koncový bod sítě, do kterého chcete odesílat data.

Výjimky

SocketException

Při přístupu k soketu došlo k chybě.

ArgumentNullException

endPoint je null.

ObjectDisposedException

Je UdpClient zavřený.

Příklady

Následující příklad používá k IPEndPoint vytvoření výchozího vzdáleného hostitele .

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

Poznámky

Metoda Connect vytvoří výchozího vzdáleného hostitele pomocí hodnoty zadané v parametru endPoint . Po vytvoření není nutné při každém volání metody zadávat vzdáleného Send hostitele.

Vytvoření výchozího vzdáleného hostitele je volitelné. Určení výchozího vzdáleného hostitele vás omezuje pouze na daného hostitele. Pokud chcete odesílat datagramy jinému vzdálenému hostiteli, musíte provést další volání Connect metody nebo vytvořit jiný UdpClient bez výchozího vzdáleného hostitele. Pokud jste vytvořili výchozího vzdáleného hostitele a ve volání metody také zadáte vzdáleného Send hostitele, Send vyvolá SocketExceptionse . Pokud se zobrazí SocketException, použijte SocketException.ErrorCode k získání konkrétního kódu chyby. Jakmile tento kód získáte, můžete se podívat do dokumentace k chybovému kódu rozhraní API rozhraní Windows Sockets verze 2 , kde najdete podrobný popis chyby.

Pokud zavoláte metodu Connect , všechny datagramy, které přicházejí z jiné než zadané výchozí adresy, budou zahozeny. Pomocí této metody nelze nastavit výchozího vzdáleného hostitele na adresu všesměrového vysílání, pokud nedědíte z UdpClient, pomocí metody Client získáte základní Socketadresu a nenastavíte možnost soketu na SocketOptionName.Broadcast.

Můžete však vysílat data na výchozí adresu všesměrového vysílání, 255.255.255.255, pokud zadáte IPAddress.Broadcast ve volání Send metody . Pokud vaše aplikace vyžaduje větší kontrolu nad adresami všesměrového vysílání, můžete se také vrátit k použití Socket třídy .

Poznámka

Vzhledem k tomu, že protokol UDP je bez připojení, Connect metoda neblokuje. Pokud chcete přijímat datagramy vícesměrového vysílání, nevolejte metodu Connect .

Viz také

Platí pro

Connect(IPAddress, Int32)

Zdroj:: UDPClient.cs

Zdroj:: UDPClient.cs

Zdroj:: UDPClient.cs

Vytvoří výchozího vzdáleného hostitele pomocí zadané IP adresy a čísla 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

Vzdáleného IPAddress hostitele, na kterého chcete odesílat data.

port: Int32

Číslo portu, na který chcete odesílat data.

Výjimky

ObjectDisposedException

UdpClient se zavře.

ArgumentNullException

addr je null.

ArgumentOutOfRangeException

port není mezi MinPort a MaxPort.

SocketException

Při přístupu k soketu došlo k chybě.

Příklady

Následující příklad používá IP adresu a číslo portu pro připojení ke vzdálenému hostiteli.

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

Poznámky

Metoda Connect vytvoří výchozího vzdáleného hostitele pomocí hodnot zadaných v parametrech addr a port . Po vytvoření není nutné při každém volání metody zadávat vzdáleného Send hostitele.

Pokud zavoláte metodu Connect , všechny datagramy, které přicházejí z jiné než zadané výchozí adresy, budou zahozeny. Pomocí této metody nelze nastavit výchozího vzdáleného hostitele na adresu všesměrového vysílání, pokud nedědíte z UdpClient, pomocí metody klienta získáte základní Socketadresu a nenastavíte možnost soketu na SocketOptionName.Broadcast.

Poznámka

Vzhledem k tomu, že protokol UDP je bez připojení, Connect metoda neblokuje. Pokud chcete přijímat datagramy vícesměrového vysílání, nevolejte metodu Connect .

Viz také

Platí pro

Connect(String, Int32)

Zdroj:: UDPClient.cs

Zdroj:: UDPClient.cs

Zdroj:: UDPClient.cs

Vytvoří výchozího vzdáleného hostitele pomocí zadaného názvu hostitele a čísla 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

Název DNS vzdáleného hostitele, na kterého chcete odesílat data.

port: Int32

Číslo portu na vzdáleném hostiteli, na který chcete odesílat data.

Výjimky

ObjectDisposedException

Je UdpClient zavřený.

ArgumentOutOfRangeException

port není mezi MinPort a MaxPort.

SocketException

Při přístupu k soketu došlo k chybě.

Příklady

Následující příklad používá název hostitele a číslo portu pro připojení ke vzdálenému hostiteli.

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

Poznámky

Metoda Connect vytvoří výchozího vzdáleného hostitele pomocí hodnot zadaných v parametrech port a hostname . Po vytvoření není nutné při každém volání metody zadávat vzdáleného Send hostitele.

Pokud jste vytvořili výchozího vzdáleného hostitele a ve volání metody také zadáte vzdáleného Send hostitele, Send vyvolá SocketExceptionse . Pokud se zobrazí SocketException, použijte SocketException.ErrorCode k získání konkrétního kódu chyby. Jakmile tento kód získáte, můžete se podívat do dokumentace k chybovému kódu rozhraní API rozhraní Windows Sockets verze 2 , kde najdete podrobný popis chyby.

Pokud zavoláte metodu Connect , všechny datagramy, které přicházejí z jiné než zadané výchozí adresy, budou zahozeny. Pomocí této metody nelze nastavit výchozího vzdáleného hostitele na adresu všesměrového vysílání, pokud nedědíte z UdpClient, pomocí metody klienta získáte základní Socketadresu a nenastavíte možnost soketu na SocketOptionName.Broadcast.

Poznámka

Vzhledem k tomu, že protokol UDP je bez připojení, Connect metoda neblokuje. Pokud chcete přijímat datagramy vícesměrového vysílání, nevolejte metodu Connect .

Viz také

Platí pro

Sdílet prostřednictvím

UdpClient.Connect Metoda

Definice

Přetížení

Connect(IPEndPoint)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Connect(IPAddress, Int32)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Connect(String, Int32)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály