TcpListener.Start Metode

Definisi

Mulai mendengarkan permintaan koneksi masuk.

Overload

Start()

Mulai mendengarkan permintaan koneksi masuk.

Start(Int32)

Mulai mendengarkan permintaan koneksi masuk dengan jumlah maksimum koneksi tertunda.

Start()

Sumber:
TCPListener.cs
Sumber:
TCPListener.cs
Sumber:
TCPListener.cs

Mulai mendengarkan permintaan koneksi masuk.

public void Start ();

Pengecualian

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.

Contoh

Contoh kode berikut menunjukkan cara Start digunakan untuk mendengarkan upaya koneksi klien masuk.

public static void DoStart(TcpListener t, int backlog)
{
    // Start listening for client connections with the
    // specified backlog.
    t.Start(backlog);
    Console.WriteLine("started listening");
}

Keterangan

Metode ini Start menginisialisasi Socket, mengikatnya ke titik akhir lokal, dan mendengarkan upaya koneksi masuk. Jika permintaan koneksi diterima, Start metode akan mengantre permintaan dan terus mendengarkan permintaan tambahan hingga Anda memanggil Stop metode . Jika TcpListener menerima permintaan koneksi setelah mengantrekan jumlah koneksi maksimum, itu akan melemparkan SocketException pada klien.

Untuk menghapus koneksi dari antrean koneksi masuk, gunakan AcceptTcpClient metode atau AcceptSocket metode . Metode ini AcceptTcpClient akan menghapus koneksi dari antrean dan mengembalikan TcpClient yang dapat Anda gunakan untuk mengirim dan menerima data. Metode ini AcceptSocket akan mengembalikan Socket yang dapat Anda gunakan untuk melakukan hal yang sama. Jika aplikasi Anda hanya memerlukan I/O sinkron, gunakan AcceptTcpClient. Untuk kontrol perilaku yang lebih rinci, gunakan AcceptSocket. Kedua metode ini memblokir hingga permintaan koneksi tersedia dalam antrean.

Stop Gunakan metode untuk menutup TcpListener dan berhenti mendengarkan. Anda bertanggung jawab untuk menutup koneksi yang anda terima secara terpisah.

Catatan

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

Lihat juga

Berlaku untuk

.NET 9 dan versi lainnya
Produk Versi
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

Start(Int32)

Sumber:
TCPListener.cs
Sumber:
TCPListener.cs
Sumber:
TCPListener.cs

Mulai mendengarkan permintaan koneksi masuk dengan jumlah maksimum koneksi tertunda.

public void Start (int backlog);

Parameter

backlog
Int32

Panjang maksimum antrean koneksi yang tertunda.

Pengecualian

Terjadi kesalahan saat mengakses soket.

Parameter backlog kurang dari nol atau melebihi jumlah maksimum koneksi yang diizinkan.

Yang mendasar Socket adalah null.

Contoh

Contoh kode berikut menunjukkan cara Start digunakan untuk mendengarkan upaya koneksi klien masuk.

public static void DoStart(TcpListener t, int backlog)
{
    // Start listening for client connections with the
    // specified backlog.
    t.Start(backlog);
    Console.WriteLine("started listening");
}

Keterangan

Metode ini Start menginisialisasi Socket, mengikatnya ke titik akhir lokal, dan mendengarkan upaya koneksi masuk. Jika permintaan koneksi diterima, Start akan mengantre permintaan dan terus mendengarkan permintaan tambahan hingga Anda memanggil Stop metode . Jika TcpListener menerima permintaan koneksi setelah mengantrekan jumlah maksimum koneksi yang akan dilemparkan SocketException pada klien.

Untuk menghapus koneksi dari antrean koneksi masuk, gunakan AcceptTcpClient metode atau AcceptSocket metode . Metode ini AcceptTcpClient akan menghapus koneksi dari antrean dan mengembalikan TcpClient yang dapat Anda gunakan untuk mengirim dan menerima data. Metode ini AcceptSocket akan mengembalikan Socket yang dapat Anda gunakan untuk melakukan hal yang sama. Jika aplikasi Anda hanya memerlukan I/O sinkron, gunakan AcceptTcpClient. Untuk kontrol perilaku yang lebih rinci, gunakan AcceptSocket metode . Kedua metode ini memblokir hingga permintaan koneksi tersedia dalam antrean.

Stop Gunakan metode untuk menutup TcpListener dan berhenti mendengarkan. Anda bertanggung jawab untuk menutup koneksi yang anda terima secara terpisah.

Catatan

SocketException.ErrorCode Gunakan properti untuk mendapatkan kode kesalahan tertentu dan lihat dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

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

Lihat juga

Berlaku untuk

.NET 9 dan versi lainnya
Produk Versi
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1