TcpClient Konstruktoren

Definition

Initialisiert eine neue Instanz der TcpClient-Klasse.

Überlädt

Name Beschreibung
TcpClient()

Initialisiert eine neue Instanz der TcpClient-Klasse.

TcpClient(IPEndPoint)

Initialisiert eine neue Instanz der TcpClient Klasse und bindet sie an den angegebenen lokalen Endpunkt.

TcpClient(AddressFamily)

Initialisiert eine neue Instanz der TcpClient Klasse mit der angegebenen Familie.

TcpClient(String, Int32)

Initialisiert eine neue Instanz der TcpClient Klasse und stellt eine Verbindung mit dem angegebenen Port auf dem angegebenen Host herstellt.

TcpClient()

Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs

Initialisiert eine neue Instanz der TcpClient-Klasse.

public:
 TcpClient();
public TcpClient();
Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Der parameterlose Konstruktor zum Erstellen eines neuen TcpClientKonstruktors verwendet wird.

//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient ();
'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient

Hinweise

Dieser Konstruktor erstellt eine neue TcpClient Und ermöglicht dem zugrunde liegenden Dienstanbieter, die am besten geeignete lokale IP-Adresse und Portnummer zuzuweisen. Sie müssen die Connect Methode zuerst aufrufen, bevor Sie Daten senden und empfangen.

Note

In .NET Framework funktioniert dieser Konstruktor nur mit IPv4-Adresstypen.

Note

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.

Weitere Informationen

Gilt für:

TcpClient(IPEndPoint)

Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs

Initialisiert eine neue Instanz der TcpClient Klasse und bindet sie an den angegebenen lokalen Endpunkt.

public:
 TcpClient(System::Net::IPEndPoint ^ localEP);
public TcpClient(System.Net.IPEndPoint localEP);
new System.Net.Sockets.TcpClient : System.Net.IPEndPoint -> System.Net.Sockets.TcpClient
Public Sub New (localEP As IPEndPoint)

Parameter

localEP
IPEndPoint

Der IPEndPoint , an den Sie den TCP Socketbinden.

Ausnahmen

Der localEP Parameter ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Instanz der TcpClient Klasse mithilfe eines lokalen Endpunkts erstellt wird.

//Creates a TCPClient using a local end point.
IPAddress ipAddress = Dns.GetHostEntry (Dns.GetHostName ()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 0);
TcpClient tcpClientA = new TcpClient (ipLocalEndPoint);
'Creates a TCPClient using a local endpoint.
Dim ipAddress As IPAddress = Dns.GetHostEntry(Dns.GetHostName()).AddressList(0)
   Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 0)

   Dim tcpClientA As New TcpClient(ipLocalEndPoint)

Hinweise

Dieser Konstruktor erstellt eine neue TcpClient und bindet ihn an den IPEndPointlocalEP angegebenen Parameter. Bevor Sie diesen Konstruktor aufrufen, müssen Sie eine IPEndPoint Verwendung der IP-Adresse und der Portnummer erstellen, von der Sie Daten senden und empfangen möchten. Sie müssen keine lokale IP-Adresse und Portnummer angeben, bevor Sie eine Verbindung herstellen und kommunizieren. Wenn Sie einen TcpClient anderen Konstruktor erstellen, weist der zugrunde liegende Dienstanbieter die am besten geeignete lokale IP-Adresse und Portnummer zu.

Sie müssen die Connect Methode aufrufen, bevor Sie Daten senden und empfangen.

Note

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.

Weitere Informationen

Gilt für:

TcpClient(AddressFamily)

Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs

Initialisiert eine neue Instanz der TcpClient Klasse mit der angegebenen Familie.

public:
 TcpClient(System::Net::Sockets::AddressFamily family);
public TcpClient(System.Net.Sockets.AddressFamily family);
new System.Net.Sockets.TcpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.TcpClient
Public Sub New (family As AddressFamily)

Parameter

family
AddressFamily

Das AddressFamily IP-Protokoll.

Ausnahmen

Der family Parameter ist nicht gleich AddressFamily.InterNetwork

-oder-

Der family Parameter ist nicht gleich AddressFamily.InterNetworkV6

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Instanz der TcpClient Klasse erstellt wird.

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);
Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Hinweise

Note

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.

Gilt für:

TcpClient(String, Int32)

Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs
Quelle:
TCPClient.cs

Initialisiert eine neue Instanz der TcpClient Klasse und stellt eine Verbindung mit dem angegebenen Port auf dem angegebenen Host herstellt.

public:
 TcpClient(System::String ^ hostname, int port);
public TcpClient(string hostname, int port);
new System.Net.Sockets.TcpClient : string * int -> System.Net.Sockets.TcpClient
Public Sub New (hostname As String, port As Integer)

Parameter

hostname
String

Der DNS-Name des Remotehosts, mit dem Sie eine Verbindung herstellen möchten.

port
Int32

Die Portnummer des Remotehosts, mit dem Sie eine Verbindung herstellen möchten.

Ausnahmen

Der hostname Parameter ist null.

Der port Parameter liegt nicht zwischen MinPort und MaxPort.

Fehler beim Zugriff auf den Socket.

Beispiele

Im folgenden Codebeispiel wird das Erstellen einer Instanz der TcpClient Klasse mithilfe eines Hostnamens und einer Portnummer veranschaulicht.

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

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

Hinweise

Dieser Konstruktor erstellt eine neue und TcpClient versucht eine synchrone Verbindung mit dem bereitgestellten Hostnamen und der Portnummer. Der zugrunde liegende Dienstanbieter weist die am besten geeignete lokale IP-Adresse und Portnummer zu. TcpClient wird blockiert, bis sie eine Verbindung herstellt oder fehlschlägt. Mit diesem Konstruktor können Sie den DNS-Hostnamen initialisieren, auflösen und eine Verbindung in einem praktischen Schritt herstellen.

Wenn IPv6 aktiviert ist und die Methode aufgerufen wird, um eine Verbindung mit einem Host herzustellen, der TcpClient(String, Int32) sowohl zu IPv6- als auch zu IPv4-Adressen aufgelöst wird, wird die Verbindung mit der IPv6-Adresse zuerst vor der IPv4-Adresse versucht. Dies kann dazu führen, dass die Zeit zum Herstellen der Verbindung verzögert wird, wenn der Host nicht auf die IPv6-Adresse lauscht.

Note

Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.

Note

Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.

Weitere Informationen

Gilt für: