Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
0 von 5 fanden dies hilfreich - Dieses Thema bewerten.

TcpClient-Klasse

Stellt Clientverbindungen für TCP-Netzwerkdienste bereit.

System.Object
  System.Net.Sockets.TcpClient

Namespace:  System.Net.Sockets
Assembly:  System (in System.dll)
public class TcpClient : IDisposable

Der TcpClient-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode TcpClient() Initialisiert eine neue Instanz der TcpClient-Klasse.
Öffentliche Methode TcpClient(AddressFamily) Initialisiert eine neue Instanz der TcpClient-Klasse mit der angegebenen Familie.
Öffentliche Methode TcpClient(IPEndPoint) Initialisiert eine neue Instanz der TcpClient-Klasse und bindet sie an den angegebenen lokalen Endpunkt.
Öffentliche Methode TcpClient(String, Int32) Initialisiert eine neue Instanz der TcpClient-Klasse und stellt eine Verbindung mit dem angegebenen Anschluss am angegebenen Host her.
Zum Seitenanfang
  Name Beschreibung
Geschützte Eigenschaft Active Ruft einen Wert ab, der angibt, ob eine Verbindung hergestellt wurde, oder legt diesen fest.
Öffentliche Eigenschaft Available Ruft die Datenmenge ab, die über das Netzwerk empfangen wurde und gelesen werden kann.
Öffentliche Eigenschaft Client Ruft den zugrunde liegenden Socket ab oder legt diesen fest.
Öffentliche Eigenschaft Connected Ruft einen Wert ab, der angibt, ob der zugrunde liegende Socket für einen TcpClient mit einem Remotehost verbunden ist.
Öffentliche Eigenschaft ExclusiveAddressUse Ruft einen Boolean-Wert ab, der angibt, ob der TcpClient nur die Verwendung eines Anschlusses durch einen einzigen Client zulässt, oder legt diesen fest.
Öffentliche Eigenschaft LingerState Ruft Informationen zum Nachlaufzustand des zugeordneten Sockets ab oder legt sie fest.
Öffentliche Eigenschaft NoDelay Ruft einen Wert ab, der eine Verzögerung deaktiviert, wenn Sende- oder Empfangspuffer nicht voll sind, oder legt diesen fest.
Öffentliche Eigenschaft ReceiveBufferSize Ruft die Größe des Empfangspuffers ab oder legt diese fest.
Öffentliche Eigenschaft ReceiveTimeout Ruft den Zeitraum ab, den ein TcpClient nach dem Initiieren eines Lesevorgangs auf den Datenempfang wartet, oder legt diesen fest.
Öffentliche Eigenschaft SendBufferSize Ruft die Größe des Sendepuffers ab oder legt diese fest.
Öffentliche Eigenschaft SendTimeout Ruft die Zeitspanne ab, die ein TcpClient auf den erfolgreichen Abschluss eines Sendevorgangs wartet, oder legt diese fest.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode BeginConnect(IPAddress, Int32, AsyncCallback, Object) Beginnt eine asynchrone Anforderung einer Remotehostverbindung. Der Remotehost wird durch eine IPAddress und eine Anschlussnummer (Int32) angegeben.
Öffentliche Methode BeginConnect(IPAddress[], Int32, AsyncCallback, Object) Beginnt eine asynchrone Anforderung einer Remotehostverbindung. Der Remotehost wird durch ein IPAddress-Array und eine Anschlussnummer (Int32) angegeben.
Öffentliche Methode BeginConnect(String, Int32, AsyncCallback, Object) Beginnt eine asynchrone Anforderung einer Remotehostverbindung. Der Remotehost wird durch einen Hostnamen (String) und eine Anschlussnummer (Int32) angegeben.
Öffentliche Methode Close Gibt diese TcpClient-Instanz frei und fordert an, dass die zugrunde liegende TCP-Verbindung geschlossen wird.
Öffentliche Methode Connect(IPEndPoint) Verbindet unter Verwendung des angegebenen Endpunkts des Remotenetzwerks den Client mit einem TCP-Remotehost.
Öffentliche Methode Connect(IPAddress, Int32) Verbindet unter Verwendung der angegebenen IP-Adresse und Anschlussnummer den Client mit einem TCP-Remotehost.
Öffentliche Methode Connect(IPAddress[], Int32) Verbindet unter Verwendung der angegebenen IP-Adressen und Anschlussnummer den Client mit einem TCP-Remotehost.
Öffentliche Methode Connect(String, Int32) Verbindet den Client mit dem angegebenen Anschluss auf dem angegebenen Host.
Geschützte Methode Dispose Gibt die von TcpClient verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei.
Öffentliche Methode EndConnect Nimmt einen eingehenden Verbindungsversuch asynchron an.
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Finalize Gibt von der TcpClient-Klasse verwendete Ressourcen frei. (Überschreibt Object.Finalize().)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetStream Gibt den für das Senden und Empfangen von Daten verwendeten NetworkStream zurück.
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang
  Name Beschreibung
Explizite Schnittstellenimplementierung Private Methode IDisposable.Dispose Infrastruktur. Gibt sämtliche vom TcpClient verwendeten Ressourcen frei.
Zum Seitenanfang

Die TcpClient-Klasse stellt einfache Methoden für die Verbindung, das Senden und Empfangen von Streamdaten in einem Netzwerk im synchronen Blockiermodus bereit.

Damit der TcpClient eine Verbindung herstellen und Daten austauschen kann, muss ein TcpListener oder Socket, der mit dem TCP-ProtocolType erstellt wurde, eingehende Verbindungsanforderungen überwachen. Sie können eine Verbindung mit diesem Listener auf zwei verschiedene Arten herstellen:

  • Erstellen Sie einen TcpClient, und rufen Sie eine der drei verfügbaren Connect-Methoden auf.

  • Erstellen Sie einen TcpClient mit dem Hostnamen und der Anschlussnummer des Remotehosts. Dieser Konstruktor versucht automatisch, eine Verbindung herzustellen.

Hinweis Hinweis

Verwenden Sie die UdpClient-Klasse, wenn Sie verbindungslose Datagramme im synchronen Blockiermodus senden möchten.

Hinweise zur Vererbung

Rufen Sie zum Senden und Empfangen von Daten einen NetworkStream mithilfe der GetStream-Methode ab. Rufen Sie die Write-Methode und die Read-Methode des NetworkStream auf, um Daten mit dem Remotehost senden und empfangen zu können. Mit der Close-Methode können Sie alle dem TcpClient zugeordneten Ressourcen freigeben.

Im folgenden Codebeispiel wird eine TcpClient-Verbindung hergestellt.


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();
}


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1
  • SocketPermission  

    Berechtigung zum Herstellen einer ausgehenden Verbindung oder Annehmen einer eingehenden Anforderung.

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?