TcpClient Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe TcpClient.
Sobrecargas
| Nome | Description |
|---|---|
| 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
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- 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 = 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
Aplica-se a
TcpClient(IPEndPoint)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- 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.TcpClientPublic Sub New (localEP As IPEndPoint)Parâmetros
- localEP
- IPEndPoint
O IPEndPoint ao qual você associa o TCP Socket.
Exceções
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.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
Aplica-se a
TcpClient(AddressFamily)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- 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.TcpClientPublic Sub New (family As AddressFamily)Parâmetros
- family
- AddressFamily
O AddressFamily do protocolo IP.
Exceções
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 = 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.
Aplica-se a
TcpClient(String, Int32)
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- Origem:
- TCPClient.cs
- 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.TcpClientPublic 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
O parâmetro hostname é null.
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 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.
