TcpListener.AcceptSocketAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Overload

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

AcceptSocketAsync()

Origine:

TCPListener.cs

Accetta una richiesta di connessione in sospeso come operazione asincrona.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::Socket ^> ^ AcceptSocketAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.Socket> AcceptSocketAsync ();

member this.AcceptSocketAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.Socket>

Public Function AcceptSocketAsync () As Task(Of Socket)

Restituisce

Task<Socket>

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

Eccezioni

InvalidOperationException

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

Commenti

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

L'oggetto Socket restituito in Task<TResult> viene inizializzato con l'indirizzo IP e il numero di porta dell'host remoto. È possibile usare uno qualsiasi dei Send metodi e Receive disponibili nella Socket classe per comunicare con l'host remoto. Al termine dell'uso di , assicurarsi di chiamare il SocketClose relativo metodo. Se l'applicazione è relativamente semplice, è consigliabile usare il AcceptTcpClient metodo anziché il AcceptSocketAsync metodo. TcpClient fornisce metodi semplici per l'invio e la ricezione di dati in una rete in modalità sincrono.

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 AcceptSocket().

Vedi anche

• AcceptTcpClient()
• Socket
• Pending()

AcceptSocketAsync(CancellationToken)

Origine:

TCPListener.cs

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

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

public System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket> AcceptSocketAsync (System.Threading.CancellationToken cancellationToken);

member this.AcceptSocketAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket>

Public Function AcceptSocketAsync (cancellationToken As CancellationToken) As ValueTask(Of Socket)

Parametri

cancellationToken

CancellationToken

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

Restituisce

ValueTask<Socket>

Oggetto dell'attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce Socket 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 socket.

L'oggetto Socket restituito in Task<TResult> viene inizializzato con l'indirizzo IP e il numero di porta dell'host remoto. È possibile usare uno qualsiasi dei Send metodi e Receive disponibili nella Socket classe per comunicare con l'host remoto. Al termine dell'uso di , assicurarsi di chiamare il SocketClose relativo metodo. Se l'applicazione è relativamente semplice, è consigliabile usare il AcceptTcpClient metodo anziché il AcceptSocketAsync metodo. TcpClient fornisce metodi semplici per l'invio e la ricezione di dati in una rete in modalità sincrono.

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 AcceptSocket().