Socket.Listen Metode

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

System.Net.Sockets.dll

Overload

Listen()	Socket Places dalam keadaan mendengarkan.
Listen(Int32)	Socket Places dalam keadaan mendengarkan.

Listen()

Sumber:

Socket.cs

Socket Places dalam keadaan mendengarkan.

public:
 void Listen();

public void Listen ();

member this.Listen : unit -> unit

Public Sub Listen ()

Keterangan

Panjang maksimum antrean koneksi yang tertunda ditentukan secara otomatis.

Listen(Int32)

Sumber:

Socket.cs

Socket Places dalam keadaan mendengarkan.

public:
 void Listen(int backlog);

public void Listen (int backlog);

member this.Listen : int -> unit

Public Sub Listen (backlog As Integer)

Parameter

backlog

Int32

Panjang maksimum antrean koneksi yang tertunda.

Pengecualian

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

ObjectDisposedException

Socket Telah ditutup.

Contoh

Contoh kode berikut menggunakan Socket untuk mendengarkan koneksi masuk.

// create the socket
Socket^ listenSocket = gcnew Socket( AddressFamily::InterNetwork,
   SocketType::Stream,
   ProtocolType::Tcp );

// bind the listening socket to the port
IPAddress^ hostIP = ( Dns::Resolve( IPAddress::Any->ToString() ) )->AddressList[ 0 ];
IPEndPoint^ ep = gcnew IPEndPoint( hostIP,port );
listenSocket->Bind( ep );

// start listening
listenSocket->Listen( backlog );

    // create the socket
    Socket listenSocket = new Socket(AddressFamily.InterNetwork,
                                     SocketType.Stream,
                                     ProtocolType.Tcp);

    // bind the listening socket to the port
IPAddress hostIP = (Dns.Resolve(IPAddress.Any.ToString())).AddressList[0];
    IPEndPoint ep = new IPEndPoint(hostIP, port);
    listenSocket.Bind(ep);

    // start listening
    listenSocket.Listen(backlog);

   ' create the socket
   Dim listenSocket As New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)
   
   ' bind the listening socket to the port
   Dim hostIP As IPAddress = Dns.Resolve(IPAddress.Any.ToString()).AddressList(0)
   Dim ep As New IPEndPoint(hostIP, port)
   listenSocket.Bind(ep)
   
   ' start listening
   listenSocket.Listen(backlog)
End Sub

Keterangan

Listen menyebabkan koneksi berorientasi Socket untuk mendengarkan upaya koneksi masuk. Parameter backlog menentukan jumlah koneksi masuk yang dapat diantrekan untuk penerimaan. Untuk menentukan jumlah maksimum koneksi yang dapat Anda tentukan, ambil nilainya MaxConnections . Listen tidak memblokir.

Jika Anda menerima SocketException, gunakan ErrorCode properti untuk mendapatkan kode kesalahan tertentu. Setelah Anda mendapatkan kode ini, lihat dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut. Gunakan Accept atau BeginAccept untuk menerima koneksi dari antrean.

Catatan

Anda harus memanggil Bind metode sebelum memanggil Listen, atau Listen akan melempar SocketException.

Catatan

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

Catatan

Parameter backlog terbatas pada nilai yang berbeda tergantung pada Sistem Operasi. Anda dapat menentukan nilai yang lebih tinggi, tetapi backlog akan dibatasi berdasarkan Sistem Operasi.

Lihat juga

• MaxConnections
• Accept()
• Bind(EndPoint)