TcpClient.Connect Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.Sockets.dll

Łączy klienta ze zdalnym hostem TCP przy użyciu określonej nazwy hosta i numeru portu.

Przeciążenia

Connect(IPEndPoint)	Łączy klienta ze zdalnym hostem TCP przy użyciu określonego punktu końcowego sieci zdalnej.
Connect(IPAddress, Int32)	Łączy klienta ze zdalnym hostem TCP przy użyciu określonego adresu IP i numeru portu.
Connect(IPAddress[], Int32)	Łączy klienta ze zdalnym hostem TCP przy użyciu określonych adresów IP i numeru portu.
Connect(String, Int32)	Łączy klienta z określonym portem na określonym hoście.

Connect(IPEndPoint)

Źródło:

TCPClient.cs

Łączy klienta ze zdalnym hostem TCP przy użyciu określonego punktu końcowego sieci zdalnej.

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

Element IPEndPoint , z którym zamierzasz nawiązać połączenie.

Wyjątki

ArgumentNullException

Parametr remoteEp ma wartość null.

SocketException

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

ObjectDisposedException

Element TcpClient jest zamknięty.

Przykłady

W poniższym przykładzie kodu użyto elementu do IPEndPoint nawiązania połączenia z hostem zdalnym.

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

Uwagi

Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta zdalnego z określonym IPEndPoint. Przed wywołaniem Connectmetody należy utworzyć wystąpienie IPEndPoint klasy przy użyciu adresu IP i numeru portu. Użyj tego IPEndPoint parametru jako parametru remoteEP . Metoda Connect zostanie zablokowana do momentu nawiązania połączenia lub niepowodzenia. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody w celu uzyskania bazowego NetworkStreamelementu . Służy do NetworkStream wysyłania i odbierania danych.

Uwaga

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.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Uwaga

Jeśli podczas korzystania z adresu IPv6 zostanie wyświetlony komunikat This protocol version is not supported NotSupportedException, upewnij się, że włączono protokół IPv6 w konstruktorze, przekazując polecenie InterNetworkV6.

Zobacz też

• IPEndPoint
• GetStream()

Connect(IPAddress, Int32)

Źródło:

TCPClient.cs

Łączy klienta ze zdalnym hostem TCP przy użyciu określonego adresu IP i numeru 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

Host IPAddress , z którym zamierzasz nawiązać połączenie.

port

Int32

Numer portu, z którym zamierzasz nawiązać połączenie.

Wyjątki

ArgumentNullException

Parametr address ma wartość null.

ArgumentOutOfRangeException

Element port nie znajduje się między elementami MinPort i MaxPort.

SocketException

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

ObjectDisposedException

TcpClient jest zamknięty.

Przykłady

W poniższym przykładzie kodu 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.
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)

Uwagi

Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta z określonym IPAddress i numerem portu. Metoda Connect zostanie zablokowana do momentu nawiązania połączenia lub niepowodzenia. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody w celu uzyskania bazowego NetworkStreamelementu . Służy do NetworkStream wysyłania i odbierania danych.

Uwaga

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.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Uwaga

Jeśli podczas korzystania z adresu IPv6 zostanie wyświetlony komunikat This protocol version is not supported NotSupportedException, upewnij się, że włączono protokół IPv6 w konstruktorze, przekazując polecenie InterNetworkV6.

Zobacz też

• GetStream()

Connect(IPAddress[], Int32)

Źródło:

TCPClient.cs

Łączy klienta ze zdalnym hostem TCP przy użyciu określonych adresów IP i numeru 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[]

Tablica IPAddress hosta, z którym zamierzasz nawiązać połączenie.

port

Int32

Numer portu, z którym zamierzasz nawiązać połączenie.

Wyjątki

ArgumentNullException

Parametr ipAddresses ma wartość null.

ArgumentOutOfRangeException

Numer portu jest nieprawidłowy.

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Element Socket został zamknięty.

SecurityException

Obiekt wywołujący wyżej w stosie wywołań nie ma uprawnień do żądanej operacji.

NotSupportedException

Ta metoda jest prawidłowa w przypadku gniazd używających InterNetwork flagi lub flagi InterNetworkV6 .

Przykłady

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

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");
}

Uwagi

Ta metoda jest zwykle używana bezpośrednio po wywołaniu BeginGetHostAddresses metody, która może zwrócić wiele adresów IP dla jednego hosta. Wywołaj metodę Connect , aby ustanowić synchroniczne połączenie hosta z hostem określonym przez tablicę IPAddress elementów i numer portu. Metoda Connect zostanie zablokowana do momentu nawiązania połączenia lub niepowodzenia. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody w celu uzyskania bazowego NetworkStreamelementu . Służy do NetworkStream wysyłania i odbierania danych.

Uwaga

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.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Uwaga

Jeśli podczas korzystania z adresu IPv6 zostanie wyświetlony komunikat This protocol version is not supported NotSupportedException, upewnij się, że włączono protokół IPv6 w konstruktorze, przekazując polecenie InterNetworkV6.

Zobacz też

• TcpListener

Connect(String, Int32)

Źródło:

TCPClient.cs

Łączy klienta z określonym portem na określonym hoście.

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, z którym zamierzasz nawiązać połączenie.

port

Int32

Numer portu hosta zdalnego, z którym zamierzasz nawiązać połączenie.

Wyjątki

ArgumentNullException

Parametr hostname ma wartość null.

ArgumentOutOfRangeException

Parametr port nie znajduje się między parametrami MinPort i MaxPort.

SocketException

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

ObjectDisposedException

TcpClient jest zamknięty.

Przykłady

W poniższym przykładzie kodu 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.
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)

Uwagi

Wywołaj tę metodę, aby ustanowić synchroniczne połączenie hosta z określoną nazwą hosta i numerem portu. Metoda Connect zostanie zablokowana do momentu nawiązania połączenia lub niepowodzenia. Po nawiązaniu połączenia z hostem zdalnym użyj GetStream metody w celu uzyskania bazowego NetworkStreamelementu . Służy do NetworkStream wysyłania i odbierania danych.

Jeśli protokół IPv6 jest włączony, a Connect(String, Int32) metoda jest wywoływana w celu nawiązania połączenia z hostem rozpoznawanym zarówno adresami IPv6, jak i IPv4, połączenie z adresem IPv6 zostanie podjęta najpierw przed adresem IPv4. Może to mieć wpływ na opóźnienie czasu ustanowienia połączenia, jeśli host nie nasłuchuje na adresie IPv6.

Uwaga

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.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Zobacz też

• Connect(EndPoint)
• GetStream()