Socket.Listen Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

Sestavení:

System.dll, System.Net.Sockets.dll

Sestavení:

System.dll

Sestavení:

netstandard.dll

Přetížení

Listen()	Umístí naslouchající Socket stav.
Listen(Int32)	Umístí naslouchající Socket stav.

Listen()

Umístí naslouchající Socket stav.

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čuje automaticky.

Listen(Int32)

Umístí naslouchající Socket stav.

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

Ta Socket byla uzavřena.

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ání příchozím pokusům o připojení. Parametr backlog určuje počet příchozích připojení, která lze zařadit 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í zpráva SocketException, použijte ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si projděte dokumentaci k chybě rozhraní API verze Windows Sockets verze 2, kde najdete podrobný popis chyby. Použijte Accept nebo BeginAccept přijměte připojení z fronty.

Poznámka

Před voláním musíte volat Listenmetodu Bind nebo Listen vyvoláte SocketException.

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)