TcpListener.Start Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

Začne naslouchat příchozím žádostem o připojení.

Přetížení

Start()	Začne naslouchat příchozím žádostem o připojení.
Start(Int32)	Začne naslouchat příchozím žádostem o připojení s maximálním počtem čekajících připojení.

Start()

Zdroj:

TCPListener.cs

Začne naslouchat příchozím žádostem o připojení.

public:
 void Start();

public void Start ();

member this.Start : unit -> unit

Public Sub Start ()

Výjimky

SocketException

ErrorCode Pomocí vlastnosti získejte konkrétní kód chyby. Jakmile tento kód získáte, můžete se podívat do dokumentace ke kódu chyb rozhraní API rozhraní Windows Sockets verze 2 , kde najdete podrobný popis chyby.

Příklady

Následující příklad kódu ukazuje, jak Start se používá k naslouchání příchozím pokusům o připojení klienta.

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

Poznámky

Metoda Start inicializuje podkladový Socketobjekt , vytvoří vazbu s místním koncovým bodem a naslouchá příchozím pokusům o připojení. Pokud se přijme žádost o připojení, Start metoda požadavek zapíše do fronty a bude naslouchat dalším žádostem, dokud metodu Stop nevoláte. Pokud TcpListener obdrží žádost o připojení poté, co už má ve frontě maximální počet připojení, vyvolá SocketException se na klientovi chyba.

Pokud chcete odebrat připojení z fronty příchozího připojení, použijte buď metodu AcceptTcpClient , nebo metodu AcceptSocket . Metoda AcceptTcpClient odebere připojení z fronty a vrátí objekt , TcpClient který můžete použít k odesílání a příjmu dat. Metoda AcceptSocket vrátí hodnotu Socket , kterou můžete použít k tomu samé. Pokud vaše aplikace vyžaduje pouze synchronní vstupně-výstupní operace, použijte AcceptTcpClient. Podrobnější řízení chování získáte pomocí příkazu AcceptSocket. Obě tyto metody blokují, dokud ve frontě není k dispozici žádost o připojení.

Stop Pomocí metody zavřete TcpListener a zastavíte naslouchání. Za zavření přijatých připojení zodpovídáte samostatně.

Poznámka

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

Viz také

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

Start(Int32)

Zdroj:

TCPListener.cs

Začne naslouchat příchozím žádostem o připojení s maximálním počtem čekajících připojení.

public:
 void Start(int backlog);

public void Start (int backlog);

member this.Start : int -> unit

Public Sub Start (backlog As Integer)

Parametry

backlog

Int32

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

Výjimky

SocketException

Při přístupu k soketu došlo k chybě.

ArgumentOutOfRangeException

Parametr backlog je menší než nula nebo překračuje maximální počet povolených připojení.

InvalidOperationException

Základní hodnota Socket má hodnotu null.

Příklady

Následující příklad kódu ukazuje, jak Start se používá k naslouchání příchozím pokusům o připojení klienta.

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

Poznámky

Metoda Start inicializuje podkladový Socketobjekt , vytvoří vazbu s místním koncovým bodem a naslouchá příchozím pokusům o připojení. Pokud je přijata žádost o připojení, Start nástroj zatkne požadavek do fronty a bude naslouchat dalším žádostem, dokud nevoláte metodu Stop . Pokud TcpListener obdrží požadavek na připojení poté, co už má ve frontě maximální počet připojení, vyvolá SocketException se na klientovi chyba.

Pokud chcete odebrat připojení z fronty příchozího připojení, použijte buď metodu AcceptTcpClient , nebo metodu AcceptSocket . Metoda AcceptTcpClient odebere připojení z fronty a vrátí objekt , TcpClient který můžete použít k odesílání a příjmu dat. Metoda AcceptSocket vrátí hodnotu Socket , kterou můžete použít k tomu samé. Pokud vaše aplikace vyžaduje pouze synchronní vstupně-výstupní operace, použijte AcceptTcpClient. Podrobnější řízení chování získáte pomocí AcceptSocket metody . Obě tyto metody blokují, dokud ve frontě není k dispozici žádost o připojení.

Stop Pomocí metody zavřete TcpListener a zastavíte naslouchání. Za zavření přijatých připojení zodpovídáte samostatně.

Poznámka

SocketException.ErrorCode Pomocí vlastnosti získejte konkrétní kód chyby a podrobný popis chyby najdete v dokumentaci ke kódu chyb rozhraní API rozhraní Windows Sockets verze 2.

Poznámka

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

Viz také

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