TcpClient.Close Método

Definição

Elimina esta TcpClient instância e solicita que a ligação TCP subjacente seja encerrada.

public:
 void Close();
public void Close();
member this.Close : unit -> unit
Public Sub Close ()

Exemplos

O exemplo de código seguinte demonstra o encerramento de a TcpClient chamando o Close método.

using System;
using System.Text;
using System.Net;
using System.Net.Sockets;

namespace Examples.System.Net
{
    public class TCPClientExample
    {
        public static void Main()
        {
            // Create a client that will connect to a
            // server listening on the contosoServer computer
            // at port 11000.
            TcpClient tcpClient = new TcpClient();
            tcpClient.Connect("contosoServer", 11000);
            // Get the stream used to read the message sent by the server.
            NetworkStream networkStream = tcpClient.GetStream();
            // Set a 10 millisecond timeout for reading.
            networkStream.ReadTimeout = 10;
            // Read the server message into a byte buffer.
            byte[] bytes = new byte[1024];
            networkStream.Read(bytes, 0, 1024);
            //Convert the server's message into a string and display it.
            string data = Encoding.UTF8.GetString(bytes);
            Console.WriteLine("Server sent message: {0}", data);
            networkStream.Close();
            tcpClient.Close();
        }
    }
}

Observações

O Close método marca a instância como eliminada e solicita que o associado Socket feche a ligação TCP. Com base na LingerState propriedade, a ligação TCP pode permanecer aberta durante algum tempo após o Close método ser chamado, quando ainda restam dados por enviar. Não há qualquer notificação quando a ligação subjacente termina de fechar.

Chamar este método resultará eventualmente no encerramento do associado Socket e também fechará o associado NetworkStream que é usado para enviar e receber dados, caso um tenha sido criado.

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