TcpListener.Start Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

Gelen bağlantı isteklerini dinlemeye başlar.

Aşırı Yüklemeler

Start()	Gelen bağlantı isteklerini dinlemeye başlar.
Start(Int32)	Bekleyen bağlantı sayısı üst sınırı olan gelen bağlantı isteklerini dinlemeye başlar.

Start()

Kaynak:

TCPListener.cs

Gelen bağlantı isteklerini dinlemeye başlar.

public:
 void Start();

public void Start ();

member this.Start : unit -> unit

Public Sub Start ()

Özel durumlar

SocketException

ErrorCode Belirli bir hata kodunu almak için özelliğini kullanın. Bu kodu edindiğinizde, hatanın ayrıntılı bir açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakabilirsiniz.

Örnekler

Aşağıdaki kod örneği, gelen istemci bağlantı girişimlerini dinlemek için nasıl Start kullanıldığını gösterir.

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

Açıklamalar

Start yöntemi, temel alınan Socketöğesini başlatır, bunu yerel bir uç noktaya bağlar ve gelen bağlantı girişimlerini dinler. Bir bağlantı isteği alınırsa, Start yöntem isteği kuyruğa alır ve siz yöntemini çağırana kadar ek istekleri dinlemeye Stop devam eder. Zaten en fazla bağlantı sayısını kuyruğa aldıktan sonra bir bağlantı isteği alırsa TcpListener , istemciye bir SocketException oluşturur.

Gelen bağlantı kuyruğundan bir bağlantıyı kaldırmak için yöntemini veya AcceptSocket yöntemini kullanınAcceptTcpClient. AcceptTcpClient yöntemi kuyruktan bir bağlantıyı kaldırır ve veri gönderip almak için kullanabileceğiniz bir TcpClient döndürür. yöntemi, AcceptSocket aynı işlemi yapmak için kullanabileceğiniz bir Socket döndürür. Uygulamanız yalnızca zaman uyumlu G/Ç gerektiriyorsa kullanın AcceptTcpClient. Daha ayrıntılı davranış denetimi için kullanın AcceptSocket. Bu yöntemlerin her ikisi de kuyrukta bir bağlantı isteği kullanılabilir olana kadar engeller.

Stop kapatmak ve dinlemeyi durdurmak için TcpListener yöntemini kullanın. Kabul edilen bağlantılarınızı ayrı ayrı kapatmak sizin sorumluluğunuzdadır.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için .NET Framework ağ izleme bölümüne bakın.

Ayrıca bkz.

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

Start(Int32)

Kaynak:

TCPListener.cs

Bekleyen bağlantı sayısı üst sınırı olan gelen bağlantı isteklerini dinlemeye başlar.

public:
 void Start(int backlog);

public void Start (int backlog);

member this.Start : int -> unit

Public Sub Start (backlog As Integer)

Parametreler

backlog

Int32

Bekleyen bağlantılar kuyruğunun uzunluk üst sınırı.

Özel durumlar

SocketException

Yuvaya erişilirken bir hata oluştu.

ArgumentOutOfRangeException

backlog parametresi sıfırdan küçük veya izin verilen bağlantı sayısı üst sınırını aşıyor.

InvalidOperationException

Temel alınan Socket değer null.

Örnekler

Aşağıdaki kod örneği, gelen istemci bağlantı girişimlerini dinlemek için nasıl Start kullanıldığını gösterir.

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

Açıklamalar

Start yöntemi, temel alınan Socketöğesini başlatır, bunu yerel bir uç noktaya bağlar ve gelen bağlantı girişimlerini dinler. Bir bağlantı isteği alınırsa, Start isteği kuyruğa alır ve siz yöntemini çağırana kadar ek istekleri dinlemeye Stop devam eder. Zaten en fazla bağlantı sayısını kuyruğa aldıktan sonra bir bağlantı isteği alırsa TcpListener , istemciye bir SocketException oluşturur.

Gelen bağlantı kuyruğundan bir bağlantıyı kaldırmak için yöntemini veya AcceptSocket yöntemini kullanınAcceptTcpClient. AcceptTcpClient yöntemi kuyruktan bir bağlantıyı kaldırır ve veri gönderip almak için kullanabileceğiniz bir TcpClient döndürür. yöntemi, AcceptSocket aynı işlemi yapmak için kullanabileceğiniz bir Socket döndürür. Uygulamanız yalnızca zaman uyumlu G/Ç gerektiriyorsa kullanın AcceptTcpClient. Daha ayrıntılı davranış denetimi için yöntemini kullanın AcceptSocket . Bu yöntemlerin her ikisi de kuyrukta bir bağlantı isteği kullanılabilir olana kadar engeller.

Stop kapatmak ve dinlemeyi durdurmak için TcpListener yöntemini kullanın. Kabul edilen bağlantılarınızı ayrı ayrı kapatmak sizin sorumluluğunuzdadır.

Not

SocketException.ErrorCode Belirli bir hata kodunu almak için özelliğini kullanın ve hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakın.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için .NET Framework ağ izleme bölümüne bakın.

Ayrıca bkz.

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