TcpClient.Connect Metoda

Definice

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaného názvu hostitele a čísla portu.

Přetížení

Connect(IPEndPoint)

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaného koncového bodu vzdálené sítě.

Connect(IPAddress, Int32)

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadané IP adresy a čísla portu.

Connect(IPAddress[], Int32)

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaných IP adres a čísla portu.

Connect(String, Int32)

Připojí klienta k zadanému portu na zadaném hostiteli.

Connect(IPEndPoint)

Zdroj:
TCPClient.cs
Zdroj:
TCPClient.cs
Zdroj:
TCPClient.cs

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaného koncového bodu vzdálené sítě.

public:
 void Connect(System::Net::IPEndPoint ^ remoteEP);
public void Connect (System.Net.IPEndPoint remoteEP);
member this.Connect : System.Net.IPEndPoint -> unit
Public Sub Connect (remoteEP As IPEndPoint)

Parametry

remoteEP
IPEndPoint

Hodnota IPEndPoint , ke které se chcete připojit.

Výjimky

Parametr remoteEp je null.

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

Příklady

Následující příklad kódu používá pro IPEndPoint připojení ke vzdálenému hostiteli .

//Uses a remote end point to establish a socket connection.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
tcpClient->Connect( ipEndPoint );
//Uses a remote endpoint to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint (ipAddress, 11004);

tcpClient.Connect (ipEndPoint);
'Uses a remote endpoint to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)

tcpClient.Connect(ipEndPoint)

Poznámky

Voláním této metody navážete synchronní vzdálené připojení hostitele k zadanému IPEndPoint. Před voláním Connectpříkazu musíte vytvořit instanci IPEndPoint třídy pomocí IP adresy a čísla portu. Použijte ho IPEndPointremoteEP jako parametr . Metoda Connect se zablokuje, dokud se buď nepřipojí, nebo selže. Po připojení ke vzdálenému hostiteli použijte metodu GetStream k získání základního NetworkStreamobjektu . NetworkStream Slouží k odesílání a přijímání dat.

Poznámka

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.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Poznámka

Pokud se při používání IPv6 adresy zobrazí výjimka NotSupportedException se zprávou This protocol version is not supported , ujistěte se, že jste v konstruktoru povolili protokol IPv6 předáním InterNetworkV6příkazu .

Viz také

Platí pro

Connect(IPAddress, Int32)

Zdroj:
TCPClient.cs
Zdroj:
TCPClient.cs
Zdroj:
TCPClient.cs

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadané IP adresy a čísla portu.

public:
 void Connect(System::Net::IPAddress ^ address, int port);
public void Connect (System.Net.IPAddress address, int port);
member this.Connect : System.Net.IPAddress * int -> unit
Public Sub Connect (address As IPAddress, port As Integer)

Parametry

address
IPAddress

Hostitel IPAddress , ke kterému se chcete připojit.

port
Int32

Číslo portu, ke kterému se chcete připojit.

Výjimky

Parametr address je null.

Hodnota port není mezi MinPort a MaxPort.

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

Příklady

Následující příklad kódu 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.
TcpClient^ tcpClient = gcnew TcpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
tcpClient->Connect( ipAddress, 11003 );
//Uses the IP address and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];

tcpClient.Connect (ipAddress, 11003);
'Uses the IP address and port number to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
tcpClient.Connect(ipAddress, 11003)

Poznámky

Voláním této metody vytvoříte synchronní připojení vzdáleného hostitele k zadanému IPAddress číslu a portu. Metoda Connect se zablokuje, dokud se buď nepřipojí, nebo selže. Po připojení ke vzdálenému hostiteli použijte metodu GetStream k získání základního NetworkStreamobjektu . NetworkStream Slouží k odesílání a přijímání dat.

Poznámka

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.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Poznámka

Pokud se při používání IPv6 adresy zobrazí výjimka NotSupportedException se zprávou This protocol version is not supported , ujistěte se, že jste v konstruktoru povolili protokol IPv6 předáním InterNetworkV6příkazu .

Viz také

Platí pro

Connect(IPAddress[], Int32)

Zdroj:
TCPClient.cs
Zdroj:
TCPClient.cs
Zdroj:
TCPClient.cs

Připojí klienta ke vzdálenému hostiteli TCP pomocí zadaných IP adres a čísla portu.

public:
 void Connect(cli::array <System::Net::IPAddress ^> ^ ipAddresses, int port);
public void Connect (System.Net.IPAddress[] ipAddresses, int port);
member this.Connect : System.Net.IPAddress[] * int -> unit
Public Sub Connect (ipAddresses As IPAddress(), port As Integer)

Parametry

ipAddresses
IPAddress[]

Pole IPAddress hostitele, ke kterému se chcete připojit.

port
Int32

Číslo portu, ke kterému se chcete připojit.

Výjimky

Parametr ipAddresses je null.

Číslo portu není platné.

Při pokusu o přístup k soketu došlo k chybě.

Volající výše v zásobníku volání nemá oprávnění k požadované operaci.

Tato metoda je platná pro sokety, které používají InterNetwork příznak nebo InterNetworkV6 příznak .

Příklady

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

static void DoConnect( String^ host, int port )
{
   // Connect to the specified host.
   TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
   array<IPAddress^>^IPAddresses = Dns::GetHostAddresses( host );
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->Connect( IPAddresses, port );
   Console::WriteLine( "Connection established" );
}
static void DoConnect(string host, int port)
{
    // Connect to the specified host.
    TcpClient t = new TcpClient(AddressFamily.InterNetwork);

    IPAddress[] IPAddresses = Dns.GetHostAddresses(host);

    Console.WriteLine("Establishing connection to {0}", host);
    t.Connect(IPAddresses, port);

    Console.WriteLine("Connection established");
}

Poznámky

Tato metoda se obvykle používá ihned po volání BeginGetHostAddresses metody , která může vrátit více IP adres pro jednoho hostitele. Connect Voláním metody navážete synchronní vzdálené připojení hostitele k hostiteli určenému IPAddress polem prvků a číslem portu. Metoda Connect se zablokuje, dokud se buď nepřipojí, nebo selže. Po připojení ke vzdálenému hostiteli použijte metodu GetStream k získání základního NetworkStreamobjektu . NetworkStream Slouží k odesílání a přijímání dat.

Poznámka

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.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Poznámka

Pokud se při používání IPv6 adresy zobrazí výjimka NotSupportedException se zprávou This protocol version is not supported , ujistěte se, že jste v konstruktoru povolili protokol IPv6 předáním InterNetworkV6příkazu .

Viz také

Platí pro

Connect(String, Int32)

Zdroj:
TCPClient.cs
Zdroj:
TCPClient.cs
Zdroj:
TCPClient.cs

Připojí klienta k zadanému portu na zadaném hostiteli.

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, ke kterému se chcete připojit.

port
Int32

Číslo portu vzdáleného hostitele, ke kterému se chcete připojit.

Výjimky

Parametr hostname je null.

Parametr port není mezi MinPort a MaxPort.

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

Příklady

Následující příklad kódu 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.
TcpClient^ tcpClient = gcnew TcpClient;
tcpClient->Connect( "www.contoso.com", 11002 );
//Uses a host name and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
tcpClient.Connect ("www.contoso.com", 11002);
'Uses a host name and port number to establish a socket connection.
Dim tcpClient As New TcpClient()

   tcpClient.Connect("www.contoso.com", 11002)

Poznámky

Voláním této metody navážete synchronní vzdálené připojení hostitele k zadanému názvu hostitele a číslu portu. Metoda Connect se zablokuje, dokud se buď nepřipojí, nebo selže. Po připojení ke vzdálenému hostiteli použijte metodu GetStream k získání základního NetworkStreamobjektu . NetworkStream Slouží k odesílání a přijímání dat.

Pokud je povolený protokol IPv6 a Connect(String, Int32) volá se metoda pro připojení k hostiteli, který se překládá na adresy IPv6 i IPv4, pokusí se o připojení k adrese IPv6 nejprve před adresou IPv4. Pokud hostitel nenaslouchá na adrese IPv6, může to zpozdit dobu navázání připojení.

Poznámka

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.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

Platí pro