TcpListener.AcceptTcpClientAsync Metode

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

System.Net.Sockets.dll

Overload

AcceptTcpClientAsync()	Menerima permintaan koneksi yang tertunda sebagai operasi asinkron.
AcceptTcpClientAsync(CancellationToken)	Menerima permintaan koneksi yang tertunda sebagai operasi asinkron yang dapat dibatalkan.

AcceptTcpClientAsync()

Sumber:

TCPListener.cs

Menerima permintaan koneksi yang tertunda sebagai operasi asinkron.

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)

Mengembalikan

Task<TcpClient>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan yang TcpClient digunakan untuk mengirim dan menerima data.

Pengecualian

InvalidOperationException

Pendengar belum dimulai dengan panggilan ke Start().

SocketException

ErrorCode Gunakan properti untuk mendapatkan kode kesalahan tertentu. Ketika Anda telah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah koneksi TCP diterima.

TcpClient.GetStream Gunakan metode untuk mendapatkan yang mendasar NetworkStream dari yang dikembalikan TcpClient di Task<TResult>. NetworkStream akan memberi Anda metode untuk mengirim dan menerima dengan host jarak jauh. Ketika Anda melalui dengan TcpClient, pastikan untuk memanggil metodenya Close . Jika Anda menginginkan fleksibilitas yang lebih besar daripada penawaran TcpClient , pertimbangkan untuk menggunakan AcceptSocket atau AcceptSocketAsync.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh AcceptTcpClient().

Lihat juga

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(CancellationToken)

Sumber:

TCPListener.cs

Menerima permintaan koneksi yang tertunda sebagai operasi asinkron yang dapat dibatalkan.

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)

Parameter

cancellationToken

CancellationToken

Token pembatalan yang dapat digunakan untuk membatalkan operasi asinkron

Mengembalikan

ValueTask<TcpClient>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan yang TcpClient digunakan untuk mengirim dan menerima data.

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah koneksi TCP diterima.

TcpClient.GetStream Gunakan metode untuk mendapatkan yang mendasar NetworkStream dari yang dikembalikan TcpClient di Task<TResult>. NetworkStream akan memberi Anda metode untuk mengirim dan menerima dengan host jarak jauh. Ketika Anda melalui dengan TcpClient, pastikan untuk memanggil metodenya Close . Jika Anda menginginkan fleksibilitas yang lebih besar daripada penawaran TcpClient , pertimbangkan untuk menggunakan AcceptSocket atau AcceptSocketAsync.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh AcceptTcpClient().