TcpListener.Start Metode

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

System.Net.Sockets.dll

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

Mulai mendengarkan permintaan koneksi masuk.

public:
 void Start();

public void Start ();

member this.Start : unit -> unit

Public Sub Start ()

Pengecualian

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.

Contoh

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

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }

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

Public Shared Sub DoStart(t As TcpListener, backlog As Integer)
   ' Start listening for client connections with the 
   ' specified backlog.
   t.Start(backlog)
   Console.WriteLine("started listening")
End Sub

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

• Listen(Int32)
• Bind(EndPoint)
• AcceptTcpClient()
• Stop()

Start(Int32)

Sumber:

TCPListener.cs

Mulai mendengarkan permintaan koneksi masuk dengan jumlah maksimum koneksi tertunda.

public:
 void Start(int backlog);

public void Start (int backlog);

member this.Start : int -> unit

Public Sub Start (backlog As Integer)

Parameter

backlog

Int32

Panjang maksimum antrean koneksi yang tertunda.

Pengecualian

SocketException

Terjadi kesalahan saat mengakses soket.

ArgumentOutOfRangeException

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

InvalidOperationException

Yang mendasar Socket adalah null.

Contoh

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

public:
    static void DoStart(TcpListener^ listener, int backlog)
    {
        // Start listening for client connections with the
        // specified backlog.
        listener->Start(backlog);
        Console::WriteLine("Started listening");
    }

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

Public Shared Sub DoStart(t As TcpListener, backlog As Integer)
   ' Start listening for client connections with the 
   ' specified backlog.
   t.Start(backlog)
   Console.WriteLine("started listening")
End Sub

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

• Listen(Int32)
• Bind(EndPoint)
• AcceptTcpClient()
• AcceptSocket()
• Stop()