TcpClient Construtores

Definição

Inicializa uma nova instância da TcpClient classe.

Sobrecargas

Name Description
TcpClient()

Inicializa uma nova instância da TcpClient classe.

TcpClient(IPEndPoint)

Inicializa uma nova instância da TcpClient classe e liga-a ao endpoint local especificado.

TcpClient(AddressFamily)

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

TcpClient(String, Int32)

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

TcpClient()

Inicializa uma nova instância da TcpClient classe.

public:
 TcpClient();
public TcpClient();
Public Sub New ()

Exemplos

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

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

Observações

Este construtor cria um novo TcpClient e permite ao fornecedor de serviço subjacente atribuir o endereço IP local e o número de porta mais apropriados. Deve primeiro chamar o Connect método antes de enviar e receber dados.

Note

No .NET Framework, este construtor funciona apenas com tipos de endereço IPv4.

Note

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

Ver também

Aplica-se a

TcpClient(IPEndPoint)

Inicializa uma nova instância da TcpClient classe e liga-a ao endpoint 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 que se atribui ao TCP Socket.

Exceções

O localEP parâmetro é null.

Exemplos

O exemplo de código seguinte demonstra como criar uma instância da TcpClient classe usando um endpoint local.

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

Observações

Este construtor cria um novo TcpClient e liga-o ao IPEndPoint especificado pelo localEP parâmetro. Antes de chamar este construtor, deve criar um IPEndPoint usando o endereço IP e o número de porta a partir dos quais pretende enviar e receber dados. Não precisa de especificar um endereço IP local e um número de porta antes de se ligar e comunicar. Se criar um TcpClient usando qualquer outro construtor, o fornecedor de serviço subjacente atribuirá o endereço IP local e o número de porta mais apropriados.

Deve chamar o Connect método antes de enviar e receber dados.

Note

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

Ver também

Aplica-se a

TcpClient(AddressFamily)

Inicializa uma nova instância da TcpClient classe 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

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

-ou-

O family parâmetro 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 = new TcpClient (AddressFamily.InterNetwork);
Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Observações

Note

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

Aplica-se a

TcpClient(String, Int32)

Inicializa uma nova instância da TcpClient classe e liga-se à 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 pretende ligar-se.

port
Int32

O número de porta do host remoto ao qual pretende ligar-se.

Exceções

O hostname parâmetro é null.

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

Ocorreu um erro ao aceder ao soquete.

Exemplos

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

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

Observações

Este construtor cria um novo TcpClient e faz uma tentativa de ligação síncrona ao nome de host e número de porta fornecidos. O fornecedor de serviços subjacente atribuirá o endereço IP local e o número de porta mais apropriados. TcpClient Vai bloquear até ligar ou falhar. Este construtor permite-lhe inicializar, resolver o nome do host DNS e ligar-se num passo conveniente.

Se o IPv6 estiver ativado e o TcpClient(String, Int32) método for chamado para se ligar a um host que resolve para os endereços IPv6 e IPv4, a ligação ao endereço IPv6 será tentada primeiro antes do endereço IPv4. Isto pode ter o efeito de atrasar o tempo para estabelecer a ligação se o anfitrião não estiver a ouvir no endereço IPv6.

Note

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

Note

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

Ver também

Aplica-se a