TcpClient Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
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.