TcpListener TcpListener TcpListener TcpListener Class

定義

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

public ref class TcpListener
public class TcpListener
type TcpListener = class
Public Class TcpListener
継承
TcpListenerTcpListenerTcpListenerTcpListener

を作成する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.IO
Imports System.Net
Imports System.Net.Sockets
Imports System.Text

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

End Class

クライアントTcpClientの例については、「」を参照してください。See TcpClient for a client example.

注釈

クラスTcpListenerには、ブロック同期モードで受信接続要求をリッスンして受け入れる単純なメソッドが用意されています。The TcpListener class provides simple methods that listen for and accept incoming connection requests in blocking synchronous mode. TcpClient TcpListenerまたはを使用して、に接続できます。 SocketYou can use either a TcpClient or a Socket to connect with a TcpListener. 、ローカルTcpListener IP アドレスIPEndPointとポート番号、またはポート番号を使用して、を作成します。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. 受信接続要求AcceptTcpClientキューから接続をプルするには、またはを使用します。AcceptSocketUse 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メソッドを呼び出します。 TcpListenerCall the Stop method to close the TcpListener.

注意

メソッドStopは、受け入れられた接続を閉じません。The Stop method does not close any accepted connections. ユーザーは、これらを個別に終了する必要があります。You are responsible for closing these separately.

コンストラクター

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.

プロパティ

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.

メソッド

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()

TcpListener クラスによって使用されていたリソースを解放します。Frees resources used by the TcpListener class.

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)

セキュリティ

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

適用対象

こちらもご覧ください