TcpClient.Client-Eigenschaft

Ruft den zugrunde liegenden Socket ab oder legt diesen fest.

Namespace: System.Net.Sockets
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property Client As Socket
'Usage
Dim instance As TcpClient
Dim value As Socket

value = instance.Client

instance.Client = value

public Socket Client { get; set; }

public:
property Socket^ Client {
    Socket^ get ();
    void set (Socket^ value);
}

/** @property */
public Socket get_Client ()

/** @property */
public void set_Client (Socket value)

public function get Client () : Socket

public function set Client (value : Socket)

Eigenschaftenwert

Der zugrunde liegende Netzwerk-Socket.

Hinweise

Der TcpClient erstellt einen Socket zum Senden und Empfangen von Daten über ein Netzwerk. Von TcpClient abgeleitete Klassen können diese Eigenschaft zum Abrufen oder Festlegen dieses Socket verwenden. Verwenden Sie den zugrunde liegenden Socket, der vom Client zurückgegeben wurde, wenn Sie mehr als den vom TcpClient bereitgestellten Zugriff benötigen. Sie können außerdem mit Client den zugrunde liegenden Socket auf einen vorhandenen Socket festlegen. Dies empfiehlt sich, wenn Sie mit einem bereits vorhandenen Socket die Vorteile des einfach zu verwendenden TcpClient nutzen möchten.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der Client-Eigenschaft veranschaulicht. In diesem Beispiel wird die Empfangspuffergröße des zugrunde liegenden Socket geändert.

Dim client As New TcpClient()
Dim s As Socket = client.Client

If Not s.Connected Then
   s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.ReceiveBuffer, 16384)
   Console.WriteLine("client is not connected, ReceiveBuffer set" + ControlChars.Lf)
Else
   Console.WriteLine("client is connected")

TcpClient client = new TcpClient();
Socket s = client.Client;

if (!s.Connected)
{
    s.SetSocketOption(SocketOptionLevel.Socket, 
                 SocketOptionName.ReceiveBuffer, 16384);
    Console.WriteLine(
        "client is not connected, ReceiveBuffer set\n");
}
else
   Console.WriteLine("client is connected");

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

TcpClient-Klasse
TcpClient-Member
System.Net.Sockets-Namespace
Socket-Klasse