TcpClient.Connect Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Net.Sockets
Assembly:
System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.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)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
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 operazione IPEndPoint come remoteEP parametro. Il Connect metodo bloccherà finché 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 del 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 abilitare IPv6 nel costruttore passando InterNetworkV6.

Vedi anche

Si applica a

Connect(IPAddress, Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
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 con 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 bloccherà finché 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 del 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 abilitare IPv6 nel costruttore passando InterNetworkV6.

Vedi anche

Si applica a

Connect(IPAddress[], Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
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 con 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 bloccherà finché 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 del 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 abilitare IPv6 nel costruttore passando InterNetworkV6.

Vedi anche

Si applica a

Connect(String, Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
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 viene usato 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 bloccherà finché 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 per 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 del 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

Si applica a