Freigeben über

TcpClient-Konstruktor (String, Int32)

Initialisiert eine neue Instanz der TcpClient-Klasse und stellt eine Verbindung mit dem angegebenen Anschluss am angegebenen Host her.

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

Syntax

'Declaration
Public Sub New ( _
    hostname As String, _
    port As Integer _
)
'Usage
Dim hostname As String
Dim port As Integer

Dim instance As New TcpClient(hostname, port)

public TcpClient (
    string hostname,
    int port
)

public:
TcpClient (
    String^ hostname, 
    int port
)

public TcpClient (
    String hostname, 
    int port
)

public function TcpClient (
    hostname : String, 
    port : int
)

Parameter

  • hostname
    Der DNS-Name des Remotehosts, mit dem eine Verbindung hergestellt werden soll.
  • port
    Die Anschlussnummer des Remotehosts, mit dem eine Verbindung hergestellt werden soll.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

hostname ist NULL (Nothing in Visual Basic).

ArgumentOutOfRangeException

port liegt nicht zwischen MinPort und MaxPort.

SocketException

Fehler beim Zugriff auf den Socket. Weitere Informationen finden Sie im Abschnitt Hinweise.

Hinweise

Dieser Konstruktor erstellt einen neuen TcpClient und versucht, eine synchrone Verbindung mit dem angegebenen Hostnamen und der Anschlussnummer herzustellen. Der zugrunde liegende Dienstanbieter weist die am besten geeignete lokale IP-Adresse und Anschlussnummer zu. TcpClient wird blockiert, bis die Verbindung entweder hergestellt wurde oder fehlgeschlagen ist. Dieser Konstruktor ermöglicht Ihnen das Initialisieren, das Auflösen des Hostnamens und das Herstellen der Verbindung in einem einzigen einfachen Schritt.

Hinweis

Wenn Sie eine SocketException erhalten, können Sie mit SocketException.ErrorCode den spezifischen Fehlercode abrufen. Nachdem Sie diesen Code abgerufen haben, finden Sie in MSDN in der Dokumentation zu API-Fehlercodes unter Windows Sockets, Version 2, eine ausführliche Beschreibung des Fehlers.

Hinweis

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

Beispiel

Im folgenden Codebeispiel wird das Erstellen einer Instanz der TcpClient-Klasse mit einem Hostnamen und einer Anschlussnummer veranschaulicht.

'Creates a TCPClient using hostname and port.

Dim tcpClientB As New TcpClient("www.contoso.com", 11000)

//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient ("www.contoso.com", 11000);

// Creates a TCPClient using hostname and port.
TcpClient^ tcpClientB = gcnew TcpClient( "www.contoso.com",11000 );

//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient("www.contoso.com", 11000);

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, 1.0

Siehe auch

Referenz

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

  • Last updated on