Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe TcpClient

 

Publicado: agosto de 2016

Fornece conexões do cliente de serviços de rede TCP.

Namespace:   System.Net.Sockets
Assembly:  System (em System.dll)

System.Object
  System.Net.Sockets.TcpClient

public class TcpClient : IDisposable

NomeDescrição
System_CAPS_pubmethodTcpClient()

Inicializa uma nova instância da classe TcpClient.

System_CAPS_pubmethodTcpClient(AddressFamily)

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

System_CAPS_pubmethodTcpClient(IPEndPoint)

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

System_CAPS_pubmethodTcpClient(String, Int32)

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

NomeDescrição
System_CAPS_protpropertyActive

Obtém ou define um valor que indica se uma conexão foi estabelecida.

System_CAPS_pubpropertyAvailable

Obtém a quantidade de dados recebidos da rede e disponíveis para leitura.

System_CAPS_pubpropertyClient

Obtém ou define o Socket subjacente.

System_CAPS_pubpropertyConnected

Obtém um valor que indica se o Socket subjacente de um TcpClient está conectado a um host remoto.

System_CAPS_pubpropertyExclusiveAddressUse

Obtém ou define um valor Boolean que especifica se o TcpClient permite que um único cliente use uma porta.

System_CAPS_pubpropertyLingerState

Obtém ou define as informações sobre o estado remanescente do soquete associado.

System_CAPS_pubpropertyNoDelay

Obtém ou define um valor que desabilita um atraso ao enviar ou receber buffers que não estão cheios.

System_CAPS_pubpropertyReceiveBufferSize

Obtém ou define o tamanho do buffer de recepção.

System_CAPS_pubpropertyReceiveTimeout

Obtém ou define a quantidade de tempo que um TcpClient aguardará para receber dados depois que uma operação de leitura for iniciada.

System_CAPS_pubpropertySendBufferSize

Obtém ou define o tamanho do buffer de envio.

System_CAPS_pubpropertySendTimeout

Obtém ou define a quantidade de tempo que um TcpClient aguardará para que uma operação de envio seja concluída com êxito.

NomeDescrição
System_CAPS_pubmethodBeginConnect(IPAddress, Int32, AsyncCallback, Object)

Inicia uma solicitação assíncrona para uma conexão de host remoto. O host remoto é especificado por um IPAddress e um número da porta (Int32).

System_CAPS_pubmethodBeginConnect(IPAddress[], Int32, AsyncCallback, Object)

Inicia uma solicitação assíncrona para uma conexão de host remoto. O host remoto é especificado por uma matriz IPAddress e um número da porta (Int32).

System_CAPS_pubmethodBeginConnect(String, Int32, AsyncCallback, Object)

Inicia uma solicitação assíncrona para uma conexão de host remoto. O host remoto é especificado por um nome do host (String) e um número da porta (Int32).

System_CAPS_pubmethodClose()

Descarta essa instância de TcpClient e solicita que a conexão TCP subjacente seja fechada.

System_CAPS_pubmethodConnect(IPAddress, Int32)

Conecta o cliente a um host TCP remoto usando o número da porta e o endereço IP especificados.

System_CAPS_pubmethodConnect(IPAddress[], Int32)

Conecta o cliente a um host TCP remoto usando o número da porta e endereços IP especificados.

System_CAPS_pubmethodConnect(IPEndPoint)

Conecta o cliente a um host TCP remoto usando o ponto de extremidade de rede remoto especificado.

System_CAPS_pubmethodConnect(String, Int32)

Conecta o cliente à porta especificada no host especificado.

System_CAPS_pubmethodConnectAsync(IPAddress, Int32)

Conecta o cliente a um host TCP remoto usando o número da porta e o endereço IP especificados como uma operação assíncrona.

System_CAPS_pubmethodConnectAsync(IPAddress[], Int32)

Conecta o cliente a um host de TCP remoto usando o número da porta e os endereços IP especificados como uma operação assíncrona.

System_CAPS_pubmethodConnectAsync(String, Int32)

Conecta o cliente à porta TCP especificada no host especificado como uma operação assíncrona.

System_CAPS_pubmethodDispose()

Libera os recursos gerenciados e não gerenciados usados pelo TcpClient.

System_CAPS_protmethodDispose(Boolean)

Libera os recursos não gerenciados usados pelo TcpClient e opcionalmente libera os recursos gerenciados.

System_CAPS_pubmethodEndConnect(IAsyncResult)

Encerra uma tentativa de conexão assíncrona pendente.

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Libera os recursos usados pela classe TcpClient.(Substitui o Object.Finalize().)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetStream()

Retorna o NetworkStream usado para enviar e receber dados.

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

The T:System.Net.Sockets.TcpClient class provides simple methods for connecting, sending, and receiving stream data over a network in synchronous blocking mode.

In order for T:System.Net.Sockets.TcpClient to connect and exchange data, a T:System.Net.Sockets.TcpListener or T:System.Net.Sockets.Socket created with the TCP T:System.Net.Sockets.ProtocolType must be listening for incoming connection requests. You can connect to this listener in one of the following two ways:

  • Create a T:System.Net.Sockets.TcpClient and call one of the three available M:System.Net.Sockets.TcpClient.Connect(System.String,System.Int32) methods.

  • Create a T:System.Net.Sockets.TcpClient using the host name and port number of the remote host. This constructor will automatically attempt a connection.

System_CAPS_noteObservação

If you want to send connectionless datagrams in synchronous blocking mode, use the T:System.Net.Sockets.UdpClient class.

Observações para os Herdeiros:

To send and receive data, use the M:System.Net.Sockets.TcpClient.GetStream method to obtain a T:System.Net.Sockets.NetworkStream. Call the M:System.Net.Sockets.NetworkStream.Write(System.Byte[],System.Int32,System.Int32) and M:System.Net.Sockets.NetworkStream.Read(System.Byte[],System.Int32,System.Int32) methods of the T:System.Net.Sockets.NetworkStream to send and receive data with the remote host. Use the M:System.Net.Sockets.NetworkStream.Close(System.Int32) method to release all resources associated with the T:System.Net.Sockets.TcpClient.

The following code example establishes a T:System.Net.Sockets.TcpClient connection.

static void Connect(String server, String message) 
{
  try 
  {
    // Create a TcpClient.
    // Note, for this client to work you need to have a TcpServer 
    // connected to the same address as specified by the server, port
    // combination.
    Int32 port = 13000;
    TcpClient client = new TcpClient(server, port);

    // Translate the passed message into ASCII and store it as a Byte array.
    Byte[] data = System.Text.Encoding.ASCII.GetBytes(message);         

    // Get a client stream for reading and writing.
   //  Stream stream = client.GetStream();

    NetworkStream stream = client.GetStream();

    // Send the message to the connected TcpServer. 
    stream.Write(data, 0, data.Length);

    Console.WriteLine("Sent: {0}", message);         

    // Receive the TcpServer.response.

    // Buffer to store the response bytes.
    data = new Byte[256];

    // String to store the response ASCII representation.
    String responseData = String.Empty;

    // Read the first batch of the TcpServer response bytes.
    Int32 bytes = stream.Read(data, 0, data.Length);
    responseData = System.Text.Encoding.ASCII.GetString(data, 0, bytes);
    Console.WriteLine("Received: {0}", responseData);         

    // Close everything.
    stream.Close();         
    client.Close();         
  } 
  catch (ArgumentNullException e) 
  {
    Console.WriteLine("ArgumentNullException: {0}", e);
  } 
  catch (SocketException e) 
  {
    Console.WriteLine("SocketException: {0}", e);
  }

  Console.WriteLine("\n Press Enter to continue...");
  Console.Read();
}

SocketPermission

Permission to establish an outgoing connection or accept an incoming request.

.NET Framework
Disponível desde 1.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: