TcpClient Construtores
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.
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.