TcpListener TcpListener TcpListener TcpListener Class

Definition

TCP ネットワーク クライアントからの接続をリッスンします。 Listens for connections from TCP network clients.

public ref class TcpListener
public class TcpListener
type TcpListener = class
Public Class TcpListener
Inheritance
TcpListenerTcpListenerTcpListenerTcpListener

Examples

次のコード例を作成、TcpListenerします。The following code example creates a TcpListener.

#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Net;
using namespace System::Net::Sockets;
using namespace System::Text;
using namespace System::Threading;
void main()
{
   try
   {
      
      // Set the TcpListener on port 13000.
      Int32 port = 13000;
      IPAddress^ localAddr = IPAddress::Parse( "127.0.0.1" );
      
      // TcpListener* server = new TcpListener(port);
      TcpListener^ server = gcnew TcpListener( localAddr,port );
      
      // Start listening for client requests.
      server->Start();
      
      // Buffer for reading data
      array<Byte>^bytes = gcnew array<Byte>(256);
      String^ data = nullptr;
      
      // Enter the listening loop.
      while ( true )
      {
         Console::Write( "Waiting for a connection... " );
         
         // Perform a blocking call to accept requests.
         // You could also user server.AcceptSocket() here.
         TcpClient^ client = server->AcceptTcpClient();
         Console::WriteLine( "Connected!" );
         data = nullptr;
         
         // Get a stream Object* for reading and writing
         NetworkStream^ stream = client->GetStream();
         Int32 i;
         
         // Loop to receive all the data sent by the client.
         while ( i = stream->Read( bytes, 0, bytes->Length ) )
         {
            
            // Translate data bytes to a ASCII String*.
            data = Text::Encoding::ASCII->GetString( bytes, 0, i );
            Console::WriteLine( "Received: {0}", data );
            
            // Process the data sent by the client.
            data = data->ToUpper();
            array<Byte>^msg = Text::Encoding::ASCII->GetBytes( data );
            
            // Send back a response.
            stream->Write( msg, 0, msg->Length );
            Console::WriteLine( "Sent: {0}", data );
         }
         
         // Shutdown and end connection
         client->Close();
      }
   }
   catch ( SocketException^ e ) 
   {
      Console::WriteLine( "SocketException: {0}", e );
   }

   Console::WriteLine( "\nHit enter to continue..." );
   Console::Read();
}


using System;
using System.IO;
using System.Net;
using System.Net.Sockets;
using System.Text;

class MyTcpListener
{
  public static void Main()
  { 
    TcpListener server=null;   
    try
    {
      // Set the TcpListener on port 13000.
      Int32 port = 13000;
      IPAddress localAddr = IPAddress.Parse("127.0.0.1");
      
      // TcpListener server = new TcpListener(port);
      server = new TcpListener(localAddr, port);

      // Start listening for client requests.
      server.Start();
         
      // Buffer for reading data
      Byte[] bytes = new Byte[256];
      String data = null;

      // Enter the listening loop.
      while(true) 
      {
        Console.Write("Waiting for a connection... ");
        
        // Perform a blocking call to accept requests.
        // You could also user server.AcceptSocket() here.
        TcpClient client = server.AcceptTcpClient();            
        Console.WriteLine("Connected!");

        data = null;

        // Get a stream object for reading and writing
        NetworkStream stream = client.GetStream();

        int i;

        // Loop to receive all the data sent by the client.
        while((i = stream.Read(bytes, 0, bytes.Length))!=0) 
        {   
          // Translate data bytes to a ASCII string.
          data = System.Text.Encoding.ASCII.GetString(bytes, 0, i);
          Console.WriteLine("Received: {0}", data);
       
          // Process the data sent by the client.
          data = data.ToUpper();

          byte[] msg = System.Text.Encoding.ASCII.GetBytes(data);

          // Send back a response.
          stream.Write(msg, 0, msg.Length);
          Console.WriteLine("Sent: {0}", data);            
        }
         
        // Shutdown and end connection
        client.Close();
      }
    }
    catch(SocketException e)
    {
      Console.WriteLine("SocketException: {0}", e);
    }
    finally
    {
       // Stop listening for new clients.
       server.Stop();
    }

      
    Console.WriteLine("\nHit enter to continue...");
    Console.Read();
  }   
}
Imports System
Imports System.IO
Imports System.Net
Imports System.Net.Sockets
Imports System.Text
Imports Microsoft.VisualBasic


Class MyTcpListener

    Public Shared Sub Main()

	Dim server As TcpListener
	server=nothing
        Try
            ' Set the TcpListener on port 13000.
         Dim port As Int32 = 13000
         Dim localAddr As IPAddress = IPAddress.Parse("127.0.0.1")

         server = New TcpListener(localAddr, port)
         
         ' Start listening for client requests.
         server.Start()
         
         ' Buffer for reading data
            Dim bytes(1024) As Byte
            Dim data As String = Nothing
         
         ' Enter the listening loop.
         While True
            Console.Write("Waiting for a connection... ")
            
            ' Perform a blocking call to accept requests.
            ' You could also user server.AcceptSocket() here.
            Dim client As TcpClient = server.AcceptTcpClient()
            Console.WriteLine("Connected!")
            
            data = Nothing
            
            ' Get a stream object for reading and writing
            Dim stream As NetworkStream = client.GetStream()
            
            Dim i As Int32
            
            ' Loop to receive all the data sent by the client.
            i = stream.Read(bytes, 0, bytes.Length)
            While (i <> 0) 
               ' Translate data bytes to a ASCII string.
               data = System.Text.Encoding.ASCII.GetString(bytes, 0, i)
                    Console.WriteLine("Received: {0}", data)
               
               ' Process the data sent by the client.
               data = data.ToUpper()
                    Dim msg As Byte() = System.Text.Encoding.ASCII.GetBytes(data)
               
               ' Send back a response.
               stream.Write(msg, 0, msg.Length)
                    Console.WriteLine("Sent: {0}", data)
              
               i = stream.Read(bytes, 0, bytes.Length)

            End While
            
            ' Shutdown and end connection
            client.Close()
         End While
      Catch e As SocketException
         Console.WriteLine("SocketException: {0}", e)
      Finally
         server.Stop()
      End Try
      
      Console.WriteLine(ControlChars.Cr + "Hit enter to continue....")
      Console.Read()
   End Sub 'Main

End Class 'MyTcpListener 

参照してくださいTcpClientクライアントなどです。See TcpClient for a client example.

Remarks

TcpListenerクラスをリッスンし、同期モードのブロックに接続要求を受け付ける単純なメソッドを提供します。The TcpListener class provides simple methods that listen for and accept incoming connection requests in blocking synchronous mode. いずれかを使用することができます、TcpClientまたはSocketで接続する、TcpListenerします。You can use either a TcpClient or a Socket to connect with a TcpListener. 作成、TcpListenerを使用して、 IPEndPoint、ローカル IP アドレスとポート番号、またはポート番号だけです。Create a TcpListener using an IPEndPoint, a Local IP address and port number, or just a port number. 指定Anyローカル IP アドレスと、基になるサービス プロバイダーにこれらの値を割り当てる場合は、ローカル ポート番号の場合は 0。Specify Any for the local IP address and 0 for the local port number if you want the underlying service provider to assign those values for you. この方法を選択する場合を使用できます、LocalEndpointソケットが接続した後、割り当てられている情報を識別するプロパティ。If you choose to do this, you can use the LocalEndpoint property to identify the assigned information, after the socket has connected.

使用して、Start受信接続要求のリッスンを開始するメソッド。Use the Start method to begin listening for incoming connection requests. Start いずれかを呼び出すまで、着信接続をキューは、Stopメソッドまたはそれがキューに入ってMaxConnectionsします。Start will queue incoming connections until you either call the Stop method or it has queued MaxConnections. いずれかを使用して、AcceptSocketまたはAcceptTcpClient着信接続要求のキューからの接続を取得します。Use either AcceptSocket or AcceptTcpClient to pull a connection from the incoming connection request queue. これら 2 つのメソッドはブロックされます。These two methods will block. 使用することができますがブロックされないようにする場合、Pending接続要求がキューで利用可能なかどうかを判断するには、最初のメソッド。If you want to avoid blocking, you can use the Pending method first to determine if connection requests are available in the queue.

呼び出す、Stopを終了するメソッド、TcpListenerします。Call the Stop method to close the TcpListener.

注意

Stop承認済みの接続は閉じられません。The Stop method does not close any accepted connections. これらを個別に閉じるためにあります。You are responsible for closing these separately.

Constructors

TcpListener(Int32) TcpListener(Int32) TcpListener(Int32) TcpListener(Int32)

指定したポートを待機する TcpListener クラスの新しいインスタンスを初期化します。 Initializes a new instance of the TcpListener class that listens on the specified port.

TcpListener(IPAddress, Int32) TcpListener(IPAddress, Int32) TcpListener(IPAddress, Int32) TcpListener(IPAddress, Int32)

指定したローカル IP アドレスとポート番号で受信接続の試行を待機する、TcpListener クラスの新しいインスタンスを初期化します。 Initializes a new instance of the TcpListener class that listens for incoming connection attempts on the specified local IP address and port number.

TcpListener(IPEndPoint) TcpListener(IPEndPoint) TcpListener(IPEndPoint) TcpListener(IPEndPoint)

指定したローカル エンドポイントを使用して、TcpListener クラスの新しいインスタンスを初期化します。 Initializes a new instance of the TcpListener class with the specified local endpoint.

Properties

Active Active Active Active

TcpListener がクライアント接続をアクティブに待機しているかどうかを示す値を取得します。 Gets a value that indicates whether TcpListener is actively listening for client connections.

ExclusiveAddressUse ExclusiveAddressUse ExclusiveAddressUse ExclusiveAddressUse

TcpListener で、1 つの基になるソケットだけに特定のポートの待機を許可するかどうかを指定する Boolean 値を取得または設定します。 Gets or sets a Boolean value that specifies whether the TcpListener allows only one underlying socket to listen to a specific port.

LocalEndpoint LocalEndpoint LocalEndpoint LocalEndpoint

現在の TcpListener の基になる EndPoint を取得します。 Gets the underlying EndPoint of the current TcpListener.

Server Server Server Server

基になるネットワーク Socket を取得します。 Gets the underlying network Socket.

Methods

AcceptSocket() AcceptSocket() AcceptSocket() AcceptSocket()

保留中の接続要求を受け入れます。 Accepts a pending connection request.

AcceptSocketAsync() AcceptSocketAsync() AcceptSocketAsync() AcceptSocketAsync()

保留中の接続要求を非同期操作として受け入れます。 Accepts a pending connection request as an asynchronous operation.

AcceptTcpClient() AcceptTcpClient() AcceptTcpClient() AcceptTcpClient()

保留中の接続要求を受け入れます。 Accepts a pending connection request.

AcceptTcpClientAsync() AcceptTcpClientAsync() AcceptTcpClientAsync() AcceptTcpClientAsync()

保留中の接続要求を非同期操作として受け入れます。 Accepts a pending connection request as an asynchronous operation.

AllowNatTraversal(Boolean) AllowNatTraversal(Boolean) AllowNatTraversal(Boolean) AllowNatTraversal(Boolean)

TcpListener インスタンスのネットワーク アドレス変換 (NAT: Network Address Translation) トラバーサルを有効または無効にします。 Enables or disables Network Address Translation (NAT) traversal on a TcpListener instance.

BeginAcceptSocket(AsyncCallback, Object) BeginAcceptSocket(AsyncCallback, Object) BeginAcceptSocket(AsyncCallback, Object) BeginAcceptSocket(AsyncCallback, Object)

受信接続の試行を受け入れる非同期操作を開始します。 Begins an asynchronous operation to accept an incoming connection attempt.

BeginAcceptTcpClient(AsyncCallback, Object) BeginAcceptTcpClient(AsyncCallback, Object) BeginAcceptTcpClient(AsyncCallback, Object) BeginAcceptTcpClient(AsyncCallback, Object)

受信接続の試行を受け入れる非同期操作を開始します。 Begins an asynchronous operation to accept an incoming connection attempt.

Create(Int32) Create(Int32) Create(Int32) Create(Int32)

指定したポートをリッスンする新しい TcpListener インスタンスを作成します。 Creates a new TcpListener instance to listen on the specified port.

EndAcceptSocket(IAsyncResult) EndAcceptSocket(IAsyncResult) EndAcceptSocket(IAsyncResult) EndAcceptSocket(IAsyncResult)

受信接続の試行を非同期的に受け入れ、新しい Socket を作成してリモート ホスト通信を処理します。 Asynchronously accepts an incoming connection attempt and creates a new Socket to handle remote host communication.

EndAcceptTcpClient(IAsyncResult) EndAcceptTcpClient(IAsyncResult) EndAcceptTcpClient(IAsyncResult) EndAcceptTcpClient(IAsyncResult)

受信接続の試行を非同期的に受け入れ、新しい TcpClient を作成してリモート ホスト通信を処理します。 Asynchronously accepts an incoming connection attempt and creates a new TcpClient to handle remote host communication.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。 Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。 Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。 Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。 Creates a shallow copy of the current Object.

(Inherited from Object)
Pending() Pending() Pending() Pending()

保留中の接続要求があるかどうかを確認します。 Determines if there are pending connection requests.

Start() Start() Start() Start()

受信接続要求のリッスンを開始します。 Starts listening for incoming connection requests.

Start(Int32) Start(Int32) Start(Int32) Start(Int32)

最大数の保留中の接続がある状態で、受信接続要求のリッスンを開始します。 Starts listening for incoming connection requests with a maximum number of pending connection.

Stop() Stop() Stop() Stop()

リスナーを閉じます。 Closes the listener.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。 Returns a string that represents the current object.

(Inherited from Object)

Security

SocketPermission
送信接続を確立するか、受信要求を受け入れます。 to establish an outgoing connection or accept an incoming request.

Applies to

See Also