TcpClient.Connect Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Connette il client a un host TCP remoto usando il nome host e il numero di porta specificati.

Overload

Connect(IPEndPoint)	Connette il client a un host TCP remoto usando l'endpoint remoto della rete specificato.
Connect(IPAddress, Int32)	Connette il client a un host TCP remoto utilizzando l'endpoint remoto della rete specificato.
Connect(IPAddress[], Int32)	Connette il client a un host TCP remoto utilizzando gli indirizzi IP e il numero di porta specificati.
Connect(String, Int32)	Connette il client alla porta specificata sull'host specificato.

Connect(IPEndPoint)

Origine:

TCPClient.cs

Connette il client a un host TCP remoto usando l'endpoint remoto della rete specificato.

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)

Parametri

remoteEP

IPEndPoint

IPEndPoint a cui si intende connettersi.

Eccezioni

ArgumentNullException

Il valore del parametro remoteEp è null.

SocketException

Si è verificato un errore durante l'accesso al socket.

ObjectDisposedException

TcpClient è chiuso.

Esempio

Nell'esempio di codice seguente viene usato un IPEndPoint oggetto per connettersi a un host remoto.

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

Commenti

Chiamare questo metodo per stabilire una connessione host remota sincrona all'oggetto specificato IPEndPoint. Prima di chiamare Connect, è necessario creare un'istanza della IPEndPoint classe usando un indirizzo IP e un numero di porta. Usare questa IPEndPoint proprietà come remoteEP parametro . Il Connect metodo verrà bloccato fino a quando non si connette o non riesce. Dopo la connessione con l'host remoto, usare il GetStream metodo per ottenere l'oggetto sottostante NetworkStream. Usare questa opzione NetworkStream per inviare e ricevere dati.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Nota

Se si riceve NotSupportedException con messaggio This protocol version is not supported durante l'uso dell'indirizzo IPv6, assicurarsi di aver abilitato IPv6 nel costruttore passando InterNetworkV6.

Vedi anche

• IPEndPoint
• GetStream()

Connect(IPAddress, Int32)

Origine:

TCPClient.cs

Connette il client a un host TCP remoto utilizzando l'endpoint remoto della rete specificato.

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)

Parametri

address

IPAddress

IPAddress dell'host a cui si desidera connettersi.

port

Int32

Numero di porta a cui si desidera connettersi.

Eccezioni

ArgumentNullException

Il valore del parametro address è null.

ArgumentOutOfRangeException

port non è compreso tra MinPort e MaxPort.

SocketException

Si è verificato un errore durante l'accesso al socket.

ObjectDisposedException

TcpClient è chiuso.

Esempio

Nell'esempio di codice seguente viene usato un indirizzo IP e un numero di porta per connettersi a un host remoto.

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

Commenti

Chiamare questo metodo per stabilire una connessione host remota sincrona al numero di porta e specificato IPAddress . Il Connect metodo verrà bloccato fino a quando non si connette o non riesce. Dopo la connessione con l'host remoto, usare il GetStream metodo per ottenere l'oggetto sottostante NetworkStream. Usare questa opzione NetworkStream per inviare e ricevere dati.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Nota

Se si riceve NotSupportedException con messaggio This protocol version is not supported durante l'uso dell'indirizzo IPv6, assicurarsi di aver abilitato IPv6 nel costruttore passando InterNetworkV6.

Vedi anche

• GetStream()

Connect(IPAddress[], Int32)

Origine:

TCPClient.cs

Connette il client a un host TCP remoto utilizzando gli indirizzi IP e il numero di porta specificati.

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)

Parametri

ipAddresses

IPAddress[]

Matrice IPAddress dell'host a cui si desidera connettersi.

port

Int32

Numero di porta a cui si desidera connettersi.

Eccezioni

ArgumentNullException

Il valore del parametro ipAddresses è null.

ArgumentOutOfRangeException

Il numero di porta non è valido.

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

ObjectDisposedException

L'oggetto Socket è stato chiuso.

SecurityException

Un chiamante di livello superiore nello stack di chiamate non ha l'autorizzazione per l'operazione richiesta.

NotSupportedException

Questo metodo è valido per i socket che utilizzano il flag InterNetwork o InterNetworkV6.

Esempio

Nell'esempio di codice seguente viene usato un indirizzo IP e un numero di porta per connettersi a un host remoto.

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

Commenti

Questo metodo viene in genere usato immediatamente dopo una chiamata al BeginGetHostAddresses metodo , che può restituire più indirizzi IP per un singolo host. Chiamare il Connect metodo per stabilire una connessione host remota sincrona all'host specificato dalla matrice di elementi e dal numero di IPAddress porta. Il Connect metodo verrà bloccato fino a quando non si connette o non riesce. Dopo la connessione con l'host remoto, usare il GetStream metodo per ottenere l'oggetto sottostante NetworkStream. Usare questa opzione NetworkStream per inviare e ricevere dati.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Nota

Se si riceve NotSupportedException con messaggio This protocol version is not supported durante l'uso dell'indirizzo IPv6, assicurarsi di aver abilitato IPv6 nel costruttore passando InterNetworkV6.

Vedi anche

• TcpListener

Connect(String, Int32)

Origine:

TCPClient.cs

Connette il client alla porta specificata sull'host specificato.

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)

Parametri

hostname

String

Nome DNS dell'host remoto a cui si intende connettersi.

port

Int32

Numero di porta dell'host remoto a cui si intende connettersi.

Eccezioni

ArgumentNullException

Il valore del parametro hostname è null.

ArgumentOutOfRangeException

Il parametro port non è compreso tra MinPort e MaxPort.

SocketException

Si è verificato un errore durante l'accesso al socket.

ObjectDisposedException

TcpClient è chiuso.

Esempio

Nell'esempio di codice seguente vengono usati il nome host e il numero di porta per connettersi a un host remoto.

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

Commenti

Chiamare questo metodo per stabilire una connessione host remota sincrona al nome host e al numero di porta specificati. Il Connect metodo verrà bloccato fino a quando non si connette o non riesce. Dopo la connessione con l'host remoto, usare il GetStream metodo per ottenere l'oggetto sottostante NetworkStream. Usare questa opzione NetworkStream per inviare e ricevere dati.

Se IPv6 è abilitato e il Connect(String, Int32) metodo viene chiamato per connettersi a un host che si risolve in indirizzi IPv6 e IPv4, la connessione all'indirizzo IPv6 verrà tentata prima dell'indirizzo IPv4. Questo può avere l'effetto di ritardare il tempo di stabilire la connessione se l'host non è in ascolto sull'indirizzo IPv6.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Vedi anche

• Connect(EndPoint)
• GetStream()