TcpClient.Close Methode

Definition

Gibt diese TcpClient-Instanz frei und fordert an, dass die zugrundeliegende TCP-Verbindung geschlossen wird.

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

Beispiele

Im folgenden Codebeispiel wird das Schließen eines TcpClient durch Aufrufen der Close -Methode veranschaulicht.

#using <System.dll>

using namespace System;
using namespace System::Text;
using namespace System::Net;
using namespace System::Net::Sockets;
int main()
{
   
   // Create a client that will connect to a 
   // server listening on the contoso1 computer
   // at port 11000.
   TcpClient^ tcpClient = gcnew 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.
   array<Byte>^bytes = gcnew array<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();
}
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();
        }
    }
}

Hinweise

Die Close -Methode markiert den instance als verworfen und fordert an, dass die zugeordnete Socket die TCP-Verbindung schließt. Basierend auf der LingerState -Eigenschaft kann die TCP-Verbindung nach dem Aufruf der Close Methode für einige Zeit geöffnet bleiben, wenn daten noch gesendet werden sollen. Es wird keine Benachrichtigung bereitgestellt, wenn das Schließen der zugrunde liegenden Verbindung abgeschlossen wurde.

Der Aufruf dieser Methode führt schließlich zum Schließen der zugeordneten Socket Methode und schließt auch die zugeordnete NetworkStream , die zum Senden und Empfangen von Daten verwendet wird, wenn eine erstellt wurde.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .NET Framework.

Gilt für: