TcpListener Construtores

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Inicializa uma nova instância da classe TcpListener.

Sobrecargas

TcpListener(Int32)	Obsoleto. Inicializa uma nova instância da classe TcpListener que escuta na porta especificada.
TcpListener(IPEndPoint)	Inicializa uma nova instância da classe TcpListener com o ponto de extremidade local especificado.
TcpListener(IPAddress, Int32)	Inicializa uma nova instância da classe TcpListener que escuta tentativas de conexões de entrada no endereço IP local e no número da porta especificados.

TcpListener(Int32)

Origem:

TCPListener.cs

Cuidado

This constructor has been deprecated. Use TcpListener(IPAddress localaddr, int port) instead.

Inicializa uma nova instância da classe TcpListener que escuta na porta especificada.

public:
 TcpListener(int port);

[System.Obsolete("This constructor has been deprecated. Use TcpListener(IPAddress localaddr, int port) instead.")]
public TcpListener (int port);

[<System.Obsolete("This constructor has been deprecated. Use TcpListener(IPAddress localaddr, int port) instead.")>]
new System.Net.Sockets.TcpListener : int -> System.Net.Sockets.TcpListener

Public Sub New (port As Integer)

Parâmetros

port

Int32

A porta na qual escutar tentativas de conexão de entrada.

Atributos

ObsoleteAttribute

Exceções

ArgumentOutOfRangeException

port não está entre MinPort e MaxPort.

Exemplos

O exemplo de código a seguir cria um TcpListener usando um número de porta local.

//Creates an instance of the TcpListener class by providing a local port number.  

IPAddress^ ipAddress = Dns::Resolve( "localhost" )->AddressList[ 0 ];

try
{
   TcpListener^ tcpListener = gcnew TcpListener( ipAddress,13 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the TcpListener class by providing a local port number.
IPAddress ipAddress = Dns.Resolve("localhost").AddressList[0];
try{
    TcpListener tcpListener =  new TcpListener(ipAddress, 13);
}
catch ( Exception e ){
    Console.WriteLine( e.ToString());
}

   'Creates an instance of the TcpListener class by providing a local port number.  
   Dim ipAddress As IPAddress = Dns.Resolve("localhost").AddressList(0)
   Try
    Dim tcpListener As New TcpListener(ipAddress, 13)
   Catch e As Exception
      Console.WriteLine(e.ToString())
   End Try

Comentários

Esse construtor é obsoleto. Use os TcpListener.TcpListener(IPAddress, Int32) construtores ou TcpListener.TcpListener(IPEndPoint) .

Esse construtor permite que você especifique o número da porta no qual escutar tentativas de conexão de entrada. Com esse construtor, o provedor de serviços subjacente atribui o endereço de rede mais apropriado. Se você não se importar com qual porta local é usada, poderá especificar 0 para o número da porta. Nesse caso, o provedor de serviços atribuirá um número de porta efêmero disponível. Se você usar essa abordagem, poderá descobrir qual endereço de rede local e o número da porta foram atribuídos usando a LocalEndpoint propriedade .

Chame o Start método para começar a escutar tentativas de conexão de entrada.

Confira também

• Start()

TcpListener(IPEndPoint)

Origem:

TCPListener.cs

Inicializa uma nova instância da classe TcpListener com o ponto de extremidade local especificado.

public:
 TcpListener(System::Net::IPEndPoint ^ localEP);

public TcpListener (System.Net.IPEndPoint localEP);

new System.Net.Sockets.TcpListener : System.Net.IPEndPoint -> System.Net.Sockets.TcpListener

Public Sub New (localEP As IPEndPoint)

Parâmetros

localEP

IPEndPoint

Um IPEndPoint que representa o ponto de extremidade local ao qual o ouvinte Socket será associado.

Exceções

ArgumentNullException

localEP é null.

Exemplos

O exemplo de código a seguir cria uma instância da TcpListener classe usando o ponto de extremidade local.

//Creates an instance of the TcpListener class by providing a local endpoint.

IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );

try
{
   TcpListener^ tcpListener = gcnew TcpListener( ipLocalEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the TcpListener class by providing a local endpoint.

IPAddress ipAddress = Dns.Resolve(Dns.GetHostName()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);

try{
    TcpListener tcpListener = new TcpListener(ipLocalEndPoint);
}
catch ( Exception e ){
    Console.WriteLine( e.ToString());
}

'Creates an instance of the TcpListener class by providing a local endpoint.
Dim ipAddress As IPAddress = Dns.Resolve(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 11000)

Try
   Dim tcpListener As New TcpListener(ipLocalEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Comentários

Esse construtor permite que você especifique o endereço IP local e o número da porta no qual escutar tentativas de conexão de entrada. Antes de usar esse construtor, você deve criar um IPEndPoint usando o endereço IP local desejado e o número da porta. Passe isso IPEndPoint para o construtor como o localEP parâmetro .

Se você não se importar com qual endereço local é atribuído, poderá criar um IPEndPoint usando IPAddress.Any como o parâmetro de endereço e o provedor de serviços subjacente atribuirá o endereço de rede mais apropriado. Isso pode ajudar a simplificar seu aplicativo se você tiver vários adaptadores de rede. Se você não se importar com qual porta local é usada, poderá criar um IPEndPoint usando 0 para o número da porta. Nesse caso, o provedor de serviços atribuirá um número de porta efêmero disponível. Se você usar essa abordagem, poderá descobrir qual endereço de rede local e o número da porta foram atribuídos usando a LocalEndpoint propriedade .

Chame o Start método para começar a escutar tentativas de conexão de entrada.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.

Confira também

• IPEndPoint
• Start()

TcpListener(IPAddress, Int32)

Origem:

TCPListener.cs

Inicializa uma nova instância da classe TcpListener que escuta tentativas de conexões de entrada no endereço IP local e no número da porta especificados.

public:
 TcpListener(System::Net::IPAddress ^ localaddr, int port);

public TcpListener (System.Net.IPAddress localaddr, int port);

new System.Net.Sockets.TcpListener : System.Net.IPAddress * int -> System.Net.Sockets.TcpListener

Public Sub New (localaddr As IPAddress, port As Integer)

Parâmetros

localaddr

IPAddress

Um IPAddress que representa o endereço IP local.

port

Int32

A porta na qual escutar tentativas de conexão de entrada.

Exceções

ArgumentNullException

localaddr é null.

ArgumentOutOfRangeException

port não está entre MinPort e MaxPort.

Exemplos

O exemplo de código a seguir cria uma instância da TcpListener classe usando um endereço IP local e um número de porta.

//Creates an instance of the TcpListener class by providing a local IP address and port number.

IPAddress^ ipAddress = Dns::Resolve( "localhost" )->AddressList[ 0 ];

try
{
   TcpListener^ tcpListener = gcnew TcpListener( ipAddress,13 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the TcpListener class by providing a local IP address and port number.

IPAddress ipAddress = Dns.Resolve("localhost").AddressList[0];

try{
    TcpListener tcpListener =  new TcpListener(ipAddress, 13);
}
catch ( Exception e){
    Console.WriteLine( e.ToString());
}

   'Creates an instance of the TcpListener class by providing a local IP address and port number.
   Dim ipAddress As IPAddress = Dns.Resolve("localhost").AddressList(0)
   
   Try
      Dim tcpListener As New TcpListener(ipAddress, 13)
   Catch e As Exception
      Console.WriteLine(e.ToString())
   End Try

Comentários

Esse construtor permite que você especifique o endereço IP local e o número da porta no qual escutar tentativas de conexão de entrada. Antes de chamar esse construtor, primeiro você deve criar um IPAddress usando o endereço local desejado. Passe isso IPAddress para o construtor como o localaddr parâmetro . Se você não se importar com qual endereço local é atribuído, especifique IPAddress.Any para o localaddr parâmetro e o provedor de serviços subjacente atribuirá o endereço de rede mais apropriado. Isso pode ajudar a simplificar seu aplicativo se você tiver vários adaptadores de rede. Se você não se importar com qual porta local é usada, poderá especificar 0 para o número da porta. Nesse caso, o provedor de serviços atribuirá um número de porta disponível entre 1024 e 65535. Se você usar essa abordagem, poderá descobrir qual endereço de rede local e o número da porta foram atribuídos usando a LocalEndpoint propriedade .

Chame o Start método para começar a escutar tentativas de conexão de entrada.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.

Confira também

• IPAddress
• Start()