TcpClient.ConnectAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.
Si è verificato un errore durante l'accesso al socket.
TcpClient è chiuso.
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
- port
- Int32
Numero di porta a cui si intende connettersi.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
Il address parametro è null.
Si è verificato un errore durante l'accesso al socket.
TcpClient è chiuso.
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
- 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).