TcpListener.AcceptTcpClientAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Overload

AcceptTcpClientAsync()	Accetta una richiesta di connessione in sospeso come operazione asincrona.
AcceptTcpClientAsync(CancellationToken)	Accetta una richiesta di connessione in sospeso come operazione asincrona annullabile.

AcceptTcpClientAsync()

Origine:

TCPListener.cs

Accetta una richiesta di connessione in sospeso come operazione asincrona.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::TcpClient ^> ^ AcceptTcpClientAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.TcpClient> AcceptTcpClientAsync ();

member this.AcceptTcpClientAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.TcpClient>

Public Function AcceptTcpClientAsync () As Task(Of TcpClient)

Restituisce

Task<TcpClient>

Oggetto dell'attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce TcpClient utilizzato per inviare e ricevere i dati.

Eccezioni

InvalidOperationException

Il listener non è stato avviato con una chiamata a Start().

SocketException

Per ottenere il codice di errore specificato, utilizzare la proprietà ErrorCode. Una volta ottenuto il codice, è possibile trovare una descrizione dettagliata dell'errore nella documentazione relativa ai codici di errore dell'API di Windows Sockets versione 2.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo l'accettazione della connessione TCP.

Utilizzare il TcpClient.GetStream metodo per ottenere l'oggetto sottostante NetworkStream dell'oggetto restituito TcpClient in Task<TResult>. fornisce NetworkStream metodi per l'invio e la ricezione con l'host remoto. Quando si esegue con TcpClient, assicurarsi di chiamare il relativo Close metodo. Se si vuole una maggiore flessibilità rispetto a un'offerta TcpClient , è consigliabile usare AcceptSocket o AcceptSocketAsync.

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.

Questo metodo archivia nell'attività 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 AcceptTcpClient().

Vedi anche

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(CancellationToken)

Origine:

TCPListener.cs

Accetta una richiesta di connessione in sospeso come operazione asincrona annullabile.

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::TcpClient ^> AcceptTcpClientAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient> AcceptTcpClientAsync (System.Threading.CancellationToken cancellationToken);

member this.AcceptTcpClientAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient>

Public Function AcceptTcpClientAsync (cancellationToken As CancellationToken) As ValueTask(Of TcpClient)

Parametri

cancellationToken

CancellationToken

Token di annullamento che può essere utilizzato per annullare l'operazione asincrona

Restituisce

ValueTask<TcpClient>

Oggetto dell'attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce TcpClient utilizzato per inviare e ricevere i dati.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo l'accettazione della connessione TCP.

Utilizzare il TcpClient.GetStream metodo per ottenere l'oggetto sottostante NetworkStream dell'oggetto restituito TcpClient in Task<TResult>. fornisce NetworkStream metodi per l'invio e la ricezione con l'host remoto. Quando si esegue con TcpClient, assicurarsi di chiamare il relativo Close metodo. Se si vuole una maggiore flessibilità rispetto a un'offerta TcpClient , è consigliabile usare AcceptSocket o AcceptSocketAsync.

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.

Questo metodo archivia nell'attività 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 AcceptTcpClient().