Socket.Listen Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

Přetížení

Listen()	Socket Places ve stavu naslouchání.
Listen(Int32)	Socket Places ve stavu naslouchání.

Listen()

Zdroj:

Socket.cs

Socket Places ve stavu naslouchání.

public:
 void Listen();

public void Listen ();

member this.Listen : unit -> unit

Public Sub Listen ()

Poznámky

Maximální délka fronty čekajících připojení se určí automaticky.

Listen(Int32)

Zdroj:

Socket.cs

Socket Places ve stavu naslouchání.

public:
 void Listen(int backlog);

public void Listen (int backlog);

member this.Listen : int -> unit

Public Sub Listen (backlog As Integer)

Parametry

backlog

Int32

Maximální délka fronty čekajících připojení.

Výjimky

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Byl Socket zavřený.

Příklady

Následující příklad kódu používá Socket k naslouchání příchozím připojením.

// 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

Poznámky

Listen způsobí, že připojení orientované Socket na naslouchá příchozím pokusům o připojení. Parametr backlog určuje počet příchozích připojení, která mohou být zařazena do fronty pro přijetí. Pokud chcete určit maximální počet připojení, která můžete zadat, načtěte MaxConnections hodnotu. Listen neblokuje.

Pokud se zobrazí SocketException, použijte ErrorCode vlastnost k získání konkrétního kódu chyby. Jakmile tento kód získáte, projděte si podrobný popis chyby v dokumentaci k rozhraní API windows Sockets verze 2 . Použijte Accept nebo BeginAccept k přijetí připojení z fronty.

Poznámka

Před voláním Listenje nutné volat metodu BindSocketException, nebo Listen vyvolá .

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

Poznámka

Parametr backlogu je omezený na různé hodnoty v závislosti na operačním systému. Můžete zadat vyšší hodnotu, ale backlog bude omezený na základě operačního systému.

Viz také

• MaxConnections
• Accept()
• Bind(EndPoint)