TcpClient.ConnectAsync Metodo

Definizione

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

Overload

Nome Descrizione
ConnectAsync(String, Int32)

Connette il client alla porta TCP specificata nell'host specificato come operazione asincrona.

ConnectAsync(IPAddress, Int32)

Connette il client a un host TCP remoto usando l'indirizzo IP e il numero di porta specificati come operazione asincrona.

ConnectAsync(IPAddress[], Int32)

Connette il client a un host TCP remoto usando gli indirizzi IP e il numero di porta specificati come operazione asincrona.

ConnectAsync(String, Int32)

Connette il client alla porta TCP specificata nell'host specificato come operazione asincrona.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);
public System.Threading.Tasks.Task ConnectAsync(string host, int port);
member this.ConnectAsync : string * int -> System.Threading.Tasks.Task
Public Function ConnectAsync (host As String, port As Integer) As Task

Parametri

host
String

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

port
Int32

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

Valori restituiti

Oggetto attività che rappresenta l'operazione asincrona.

Eccezioni

Il host parametro è null.

Il port parametro non è compreso tra MinPort e MaxPort.

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

Commenti

Questa operazione non verrà bloccata. L'oggetto Returns Task restituito verrà completato dopo che è stata stabilita la connessione TCP. Questo metodo non blocca il thread chiamante mentre è in corso la richiesta di connessione.

Chiamare questo metodo per stabilire una connessione host remota sincrona al nome host e al numero di porta specificati come operazione asincrona. 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 ConnectAsync(String, Int32) metodo viene chiamato per connettersi a un host che si risolve sia in indirizzi IPv6 che 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.

Note

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.

Note

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Network Tracing in the .NET Framework.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Connect(String, Int32).

Vedi anche

Si applica a

ConnectAsync(IPAddress, Int32)

Connette il client a un host TCP remoto usando l'indirizzo IP e il numero di porta specificati come operazione asincrona.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);
public System.Threading.Tasks.Task ConnectAsync(System.Net.IPAddress address, int port);
member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task
Public Function ConnectAsync (address As IPAddress, port As Integer) As Task

Parametri

address
IPAddress

Oggetto IPAddress dell'host a cui si intende connettersi.

port
Int32

Numero di porta a cui si intende connettersi.

Valori restituiti

Oggetto attività che rappresenta l'operazione asincrona.

Eccezioni

Il address parametro è null.

non port è compreso tra MinPort e MaxPort.

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

Commenti

Questa operazione non verrà bloccata. L'oggetto Returns Task restituito verrà completato dopo che è stata stabilita la connessione TCP. Questo metodo non blocca il thread chiamante mentre è in corso la richiesta di connessione.

Chiamare questo metodo per stabilire una connessione host remota sincrona al numero di porta e specificato IPAddress come operazione asincrona. 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.

Note

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.

Note

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Network Tracing in the .NET Framework.

Note

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.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Connect(IPAddress, Int32).

Vedi anche

Si applica a

ConnectAsync(IPAddress[], Int32)

Connette il client a un host TCP remoto usando gli indirizzi IP e il numero di porta specificati come operazione asincrona.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);
public System.Threading.Tasks.Task ConnectAsync(System.Net.IPAddress[] addresses, int port);
member this.ConnectAsync : System.Net.IPAddress[] * int -> System.Threading.Tasks.Task
Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task

Parametri

addresses
IPAddress[]

Matrice IPAddress dell'host a cui si intende connettersi.

port
Int32

Numero di porta a cui si intende connettersi.

Valori restituiti

Oggetto attività che rappresenta l'operazione asincrona.

Eccezioni

Il addresses parametro è null.

Il numero di porta non è valido.

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

L'oggetto Socket è stato chiuso.

Un chiamante superiore nello stack di chiamate non dispone dell'autorizzazione per l'operazione richiesta.

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

Commenti

Questa operazione non verrà bloccata. L'oggetto Returns Task restituito verrà completato dopo che è stata stabilita la connessione TCP. Questo metodo non blocca il thread chiamante mentre è in corso la richiesta di connessione.

Questo metodo viene in genere usato immediatamente dopo una chiamata al BeginGetHostAddresses metodo , che può restituire più indirizzi IP per un singolo host. Chiamare questo metodo per stabilire una connessione host remota sincrona all'host specificato dalla matrice di elementi e il numero di IPAddress porta come operazione asincrona. 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.

Note

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.

Note

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Network Tracing in the .NET Framework.

Note

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.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Connect(IPAddress[], Int32).

Vedi anche

Si applica a