TcpClient Construtores

Definição

Inicializa uma nova instância da classe TcpClient.Initializes a new instance of the TcpClient class.

Sobrecargas

TcpClient()

Inicializa uma nova instância da classe TcpClient.Initializes a new instance of the TcpClient class.

TcpClient(IPEndPoint)

Inicializa uma nova instância da classe TcpClient e a associa ao ponto de extremidade local especificado.Initializes a new instance of the TcpClient class and binds it to the specified local endpoint.

TcpClient(AddressFamily)

Inicializa uma nova instância da classe TcpClient com a família especificada.Initializes a new instance of the TcpClient class with the specified family.

TcpClient(String, Int32)

Inicializa uma nova instância da classe TcpClient e se conecta à porta especificada no host especificado.Initializes a new instance of the TcpClient class and connects to the specified port on the specified host.

TcpClient()

Inicializa uma nova instância da classe TcpClient.Initializes a new instance of the TcpClient class.

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 .The following code example demonstrates how to use the parameterless constructor to create a new 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 número de porta e o endereço IP local mais apropriado.This constructor creates a new TcpClient and allows the underlying service provider to assign the most appropriate local IP address and port number. Primeiro, você deve chamar o Connect método antes de enviar e receber dados.You must first call the Connect method before sending and receiving data.

Observação

Esse construtor funciona apenas com tipos de endereço IPv4.This constructor works only with IPv4 address types.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a

TcpClient(IPEndPoint)

Inicializa uma nova instância da classe TcpClient e a associa ao ponto de extremidade local especificado.Initializes a new instance of the TcpClient class and binds it to the specified local endpoint.

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.The IPEndPoint to which you bind the TCP Socket.

Exceções

O parâmetro localEP é null.The localEP parameter is null.

Exemplos

O exemplo de código a seguir demonstra como criar uma instância da TcpClient classe usando um ponto de extremidade local.The following code example demonstrates how to create an instance of the TcpClient class using a local endpoint.

//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.This constructor creates a new TcpClient and binds it to the IPEndPoint specified by the localEP parameter. Antes de chamar esse construtor, você deve criar um IPEndPoint usando o endereço IP e o número da porta do qual você pretende enviar e receber dados.Before you call this constructor, you must create an IPEndPoint using the IP address and port number from which you intend to send and receive data. Você não precisa especificar um endereço IP local e um número de porta antes de se conectar e se comunicar.You do not need to specify a local IP address and port number before connecting and communicating. Se você criar um TcpClient usando qualquer outro construtor, o provedor de serviços subjacente atribuirá o número de porta e o endereço IP local mais apropriado.If you create a TcpClient using any other constructor, the underlying service provider will assign the most appropriate local IP address and port number.

Você deve chamar o Connect método antes de enviar e receber dados.You must call the Connect method before sending and receiving data.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a

TcpClient(AddressFamily)

Inicializa uma nova instância da classe TcpClient com a família especificada.Initializes a new instance of the TcpClient class with the specified family.

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.The AddressFamily of the IP protocol.

Exceções

O parâmetro family não é igual a AddressFamily.InterNetworkThe family parameter is not equal to AddressFamily.InterNetwork - ou --or- O parâmetro family não é igual a AddressFamily.InterNetworkV6The family parameter is not equal to AddressFamily.InterNetworkV6

Exemplos

O exemplo de código a seguir demonstra como criar uma instância da TcpClient classe.The following code example demonstrates how to create an instance of the TcpClient class.

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.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Aplica-se a

TcpClient(String, Int32)

Inicializa uma nova instância da classe TcpClient e se conecta à porta especificada no host especificado.Initializes a new instance of the TcpClient class and connects to the specified port on the specified host.

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.The DNS name of the remote host to which you intend to connect.

port
Int32

O número da porta do host remoto ao qual você pretende se conectar.The port number of the remote host to which you intend to connect.

Exceções

O parâmetro hostname é null.The hostname parameter is null.

O parâmetro port não está entre MinPort e MaxPort.The port parameter is not between MinPort and MaxPort.

Ocorreu um erro ao acessar o soquete.An error occurred when accessing the socket.

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.The following code example demonstrates how to create an instance of the TcpClient class using a host name and port number.

// 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 de host fornecido e o número da porta.This constructor creates a new TcpClient and makes a synchronous connection attempt to the provided host name and port number. O provedor de serviços subjacente atribuirá o número da porta e o endereço IP local mais apropriado.The underlying service provider will assign the most appropriate local IP address and port number. TcpClient será bloqueado até que seja conectado ou falhe.TcpClient will block until it either connects or fails. Esse construtor permite que você inicialize, resolva o nome do host DNS e conecte-se em uma etapa conveniente.This constructor allows you to initialize, resolve the DNS host name, and connect in one convenient step.

Se o IPv6 estiver habilitado e o TcpClient(String, Int32) método for chamado para se conectar a um host que seja resolvido para endereços IPv6 e IPv4, a conexão com o endereço IPv6 será tentada primeiro antes do endereço IPv4.If IPv6 is enabled and the TcpClient(String, Int32) method is called to connect to a host that resolves to both IPv6 and IPv4 addresses, the connection to the IPv6 address will be attempted first before the IPv4 address. 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.This may have the effect of delaying the time to establish the connection if the host is not listening on the IPv6 address.

Observação

Se você receber um SocketException , use SocketException.ErrorCode para obter o código de erro específico.If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. 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.After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede na .NET Framework.For more information, see Network Tracing in the .NET Framework.

Confira também

Aplica-se a