TcpClient.Connect Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

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

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

ArgumentNullException

Parametr remoteEp je null.

SocketException

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

ObjectDisposedException

Je TcpClient zavřený.

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é

• IPEndPoint
• GetStream()

Connect(IPAddress, Int32)

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

ArgumentNullException

Parametr address je null.

ArgumentOutOfRangeException

Hodnota port není mezi MinPort a MaxPort.

SocketException

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

ObjectDisposedException

TcpClient se zavře.

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é

• GetStream()

Connect(IPAddress[], Int32)

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

ArgumentNullException

Parametr ipAddresses je null.

ArgumentOutOfRangeException

Číslo portu není platné.

SocketException

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

ObjectDisposedException

Byla Socket uzavřena.

SecurityException

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

NotSupportedException

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é

• TcpListener

Connect(String, Int32)

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

ArgumentNullException

Parametr hostname je null.

ArgumentOutOfRangeException

Parametr port není mezi MinPort a MaxPort.

SocketException

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

ObjectDisposedException

TcpClient se zavře.

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é

• Connect(EndPoint)
• GetStream()