Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
TcpClient-Klasse
Stellt Clientverbindungen für TCP-Netzwerkdienste bereit.
Assembly: System (in System.dll)
Der TcpClient-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
TcpClient() | Initialisiert eine neue Instanz der TcpClient-Klasse. |
|
TcpClient(AddressFamily) | Initialisiert eine neue Instanz der TcpClient-Klasse mit der angegebenen Familie. |
|
TcpClient(IPEndPoint) | Initialisiert eine neue Instanz der TcpClient-Klasse und bindet sie an den angegebenen lokalen Endpunkt. |
|
TcpClient(String, Int32) | Initialisiert eine neue Instanz der TcpClient-Klasse und stellt eine Verbindung mit dem angegebenen Anschluss am angegebenen Host her. |
| Name | Beschreibung | |
|---|---|---|
|
Active | Ruft einen Wert ab, der angibt, ob eine Verbindung hergestellt wurde, oder legt diesen fest. |
|
Available | Ruft die Datenmenge ab, die über das Netzwerk empfangen wurde und gelesen werden kann. |
|
Client | Ruft den zugrunde liegenden Socket ab oder legt diesen fest. |
|
Connected | Ruft einen Wert ab, der angibt, ob der zugrunde liegende Socket für einen TcpClient mit einem Remotehost verbunden ist. |
|
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. |
|
LingerState | Ruft Informationen zum Nachlaufzustand des zugeordneten Sockets ab oder legt sie fest. |
|
NoDelay | Ruft einen Wert ab, der eine Verzögerung deaktiviert, wenn Sende- oder Empfangspuffer nicht voll sind, oder legt diesen fest. |
|
ReceiveBufferSize | Ruft die Größe des Empfangspuffers ab oder legt diese fest. |
|
ReceiveTimeout | Ruft den Zeitraum ab, den ein TcpClient nach dem Initiieren eines Lesevorgangs auf den Datenempfang wartet, oder legt diesen fest. |
|
SendBufferSize | Ruft die Größe des Sendepuffers ab oder legt diese fest. |
|
SendTimeout | Ruft die Zeitspanne ab, die ein TcpClient auf den erfolgreichen Abschluss eines Sendevorgangs wartet, oder legt diese fest. |
| Name | Beschreibung | |
|---|---|---|
|
BeginConnect(IPAddress, Int32, AsyncCallback, Object) | Beginnt eine asynchrone Anforderung einer Remotehostverbindung. Der Remotehost wird durch eine IPAddress und eine Anschlussnummer (Int32) angegeben. |
|
BeginConnect(IPAddress[], Int32, AsyncCallback, Object) | Beginnt eine asynchrone Anforderung einer Remotehostverbindung. Der Remotehost wird durch ein IPAddress-Array und eine Anschlussnummer (Int32) angegeben. |
|
BeginConnect(String, Int32, AsyncCallback, Object) | Beginnt eine asynchrone Anforderung einer Remotehostverbindung. Der Remotehost wird durch einen Hostnamen (String) und eine Anschlussnummer (Int32) angegeben. |
|
Close | Gibt diese TcpClient-Instanz frei und fordert an, dass die zugrunde liegende TCP-Verbindung geschlossen wird. |
|
Connect(IPEndPoint) | Verbindet unter Verwendung des angegebenen Endpunkts des Remotenetzwerks den Client mit einem TCP-Remotehost. |
|
Connect(IPAddress, Int32) | Verbindet unter Verwendung der angegebenen IP-Adresse und Anschlussnummer den Client mit einem TCP-Remotehost. |
|
Connect(IPAddress[], Int32) | Verbindet unter Verwendung der angegebenen IP-Adressen und Anschlussnummer den Client mit einem TCP-Remotehost. |
|
Connect(String, Int32) | Verbindet den Client mit dem angegebenen Anschluss auf dem angegebenen Host. |
|
Dispose | Gibt die von TcpClient verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. |
|
EndConnect | Nimmt einen eingehenden Verbindungsversuch asynchron an. |
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
Finalize | Gibt von der TcpClient-Klasse verwendete Ressourcen frei. (Überschreibt Object.Finalize().) |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetStream | Gibt den für das Senden und Empfangen von Daten verwendeten NetworkStream zurück. |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
MemberwiseClone | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
ToString | Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
IDisposable.Dispose | Infrastruktur. Gibt sämtliche vom TcpClient verwendeten Ressourcen frei. |
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
|
|---|
|
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(); }
-
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.
Hinweis