TcpClient Construtores

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Inicializa uma nova instância da classe TcpClient.

Sobrecargas

TcpClient()	Inicializa uma nova instância da classe TcpClient.
TcpClient(IPEndPoint)	Inicializa uma nova instância da classe TcpClient e a associa ao ponto de extremidade local especificado.
TcpClient(AddressFamily)	Inicializa uma nova instância da classe TcpClient com a família especificada.
TcpClient(String, Int32)	Inicializa uma nova instância da classe TcpClient e se conecta à porta especificada no host especificado.

TcpClient()

Origem:

TCPClient.cs

Inicializa uma nova instância da classe TcpClient.

public:
 TcpClient();

public TcpClient ();

Public Sub New ()

Exemplos

O exemplo de código a seguir demonstra como usar o construtor sem parâmetros para criar um novo TcpClient.

//Creates a TCPClient using the default constructor.
TcpClient^ tcpClientC = gcnew TcpClient;

//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient ();

'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient

Comentários

Esse construtor cria um novo TcpClient e permite que o provedor de serviços subjacente atribua o endereço IP local e o número da porta mais apropriados. Primeiro, você deve chamar o Connect método antes de enviar e receber dados.

Observação

Em .NET Framework, esse construtor funciona apenas com tipos de endereço IPv4.

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

• Connect(String, Int32)

TcpClient(IPEndPoint)

Origem:

TCPClient.cs

Inicializa uma nova instância da classe TcpClient e a associa ao ponto de extremidade local especificado.

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

public TcpClient (System.Net.IPEndPoint localEP);

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

Public Sub New (localEP As IPEndPoint)

Parâmetros

localEP

IPEndPoint

O IPEndPoint ao qual você associa o TCP Socket.

Exceções

ArgumentNullException

O parâmetro localEP é null.

Exemplos

O exemplo de código a seguir demonstra como criar uma instância da TcpClient classe usando um ponto de extremidade local.

//Creates a TCPClient using a local end point.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );
TcpClient^ tcpClientA = gcnew TcpClient( ipLocalEndPoint );

//Creates a TCPClient using a local end point.
IPAddress ipAddress = Dns.GetHostEntry (Dns.GetHostName ()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 0);
TcpClient tcpClientA = new TcpClient (ipLocalEndPoint);

'Creates a TCPClient using a local endpoint.
Dim ipAddress As IPAddress = Dns.GetHostEntry(Dns.GetHostName()).AddressList(0)
   Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 0)

   Dim tcpClientA As New TcpClient(ipLocalEndPoint)

Comentários

Esse construtor cria um novo TcpClient e o associa ao IPEndPoint especificado pelo localEP parâmetro . Antes de chamar esse construtor, você deve criar um IPEndPoint usando o endereço IP e o número da porta do qual pretende enviar e receber dados. Você não precisa especificar um endereço IP local e um número de porta antes de se conectar e se comunicar. Se você criar um TcpClient usando qualquer outro construtor, o provedor de serviços subjacente atribuirá o endereço IP local e o número da porta mais apropriados.

Você deve chamar o Connect método antes de enviar e receber dados.

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
• Connect(String, Int32)

TcpClient(AddressFamily)

Origem:

TCPClient.cs

Inicializa uma nova instância da classe TcpClient com a família especificada.

public:
 TcpClient(System::Net::Sockets::AddressFamily family);

public TcpClient (System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.TcpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.TcpClient

Public Sub New (family As AddressFamily)

Parâmetros

family

AddressFamily

O AddressFamily do protocolo IP.

Exceções

ArgumentException

O parâmetro family não é igual a AddressFamily.InterNetwork

- ou -

O parâmetro family não é igual a AddressFamily.InterNetworkV6

Exemplos

O exemplo de código a seguir demonstra como criar uma instância da TcpClient classe .

TcpClient^ tcpClientD = gcnew TcpClient( AddressFamily::InterNetwork );

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Comentários

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.

TcpClient(String, Int32)

Origem:

TCPClient.cs

Inicializa uma nova instância da classe TcpClient e se conecta à porta especificada no host especificado.

public:
 TcpClient(System::String ^ hostname, int port);

public TcpClient (string hostname, int port);

new System.Net.Sockets.TcpClient : string * int -> System.Net.Sockets.TcpClient

Public Sub New (hostname As String, port As Integer)

Parâmetros

hostname

String

O nome DNS do host remoto ao qual você pretende se conectar.

port

Int32

O número da porta do host remoto ao qual você pretende se conectar.

Exceções

ArgumentNullException

O parâmetro hostname é null.

ArgumentOutOfRangeException

O parâmetro port não está entre MinPort e MaxPort.

SocketException

Ocorreu um erro ao acessar o soquete.

Exemplos

O exemplo de código a seguir demonstra como criar uma instância da TcpClient classe usando um nome de host e um número de porta.

// Creates a TCPClient using hostname and port.
TcpClient^ tcpClientB = gcnew TcpClient( "www.contoso.com",11000 );

//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient ("www.contoso.com", 11000);

'Creates a TCPClient using hostname and port.

Dim tcpClientB As New TcpClient("www.contoso.com", 11000)

Comentários

Esse construtor cria um novo TcpClient e faz uma tentativa de conexão síncrona com o nome do host e o número da porta fornecidos. O provedor de serviços subjacente atribuirá o endereço IP local e o número da porta mais apropriados. TcpClient bloqueará até que ele se conecte ou falhe. Esse construtor permite inicializar, resolve o nome do host DNS e se conectar em uma etapa conveniente.

Se iPv6 estiver habilitado e o TcpClient(String, Int32) método for chamado para se conectar a um host que resolva para endereços IPv6 e IPv4, a conexão com o endereço IPv6 será tentada primeiro antes do endereço IPv4. Isso pode ter o efeito de atrasar o tempo para estabelecer a conexão se o host não estiver escutando no endereço IPv6.

Observação

Se você receber um SocketException, use SocketException.ErrorCode para obter o código de erro específico. Depois de obter esse código, você pode consultar a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

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

• TcpClient
• Connect(String, Int32)