Share via


TcpListener.AcceptTcpClientAsync Metodo

Definizione

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
Origine:
TCPListener.cs
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

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

Eccezioni

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

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 il sottostante NetworkStream dell'oggetto Task<TResult>restituito TcpClient in . Fornisce NetworkStream metodi per l'invio e la ricezione con l'host remoto. Quando si esegue con , TcpClientassicurarsi di chiamare il Close relativo metodo. Se si vuole maggiore flessibilità rispetto a un'offerta TcpClient , prendere in considerazione l'uso 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à 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 AcceptTcpClient().

Vedi anche

Si applica a

AcceptTcpClientAsync(CancellationToken)

Origine:
TCPListener.cs
Origine:
TCPListener.cs
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 usato per annullare l'operazione asincrona

Restituisce

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

Eccezioni

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 il sottostante NetworkStream dell'oggetto Task<TResult>restituito TcpClient in . Fornisce NetworkStream metodi per l'invio e la ricezione con l'host remoto. Quando si esegue con , TcpClientassicurarsi di chiamare il Close relativo metodo. Se si vuole maggiore flessibilità rispetto a un'offerta TcpClient , prendere in considerazione l'uso 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à 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 AcceptTcpClient().

Si applica a