TcpClient Konstruktoren

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Initialisiert eine neue Instanz der TcpClient-Klasse.

Überlädt

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 am angegebenen Host her.

TcpClient()

Quelle:

TCPClient.cs

Initialisiert eine neue Instanz der TcpClient-Klasse.

public:
 TcpClient();

public TcpClient ();

Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie den parameterlosen Konstruktor verwenden, um eine neue TcpClientzu erstellen.

//Creates a TCPClient using the default constructor.
TcpClient^ tcpClientC = gcnew TcpClient;

//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 es dem zugrunde liegenden Dienstanbieter, die am besten geeignete lokale IP-Adresse und Portnummer zuzuweisen. Sie müssen zuerst die Connect -Methode aufrufen, bevor Sie Daten senden und empfangen.

Hinweis

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

Hinweis

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

Weitere Informationen

• Connect(String, Int32)

TcpClient(IPEndPoint)

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 der TCP-Socket gebunden wird.

Ausnahmen

ArgumentNullException

Der localEP-Parameter ist null.

Beispiele

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

//Creates a TCPClient using a local end point.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );
TcpClient^ tcpClientA = gcnew TcpClient( ipLocalEndPoint );

//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 die IPEndPoint durch den localEP -Parameter angegebene. Bevor Sie diesen Konstruktor aufrufen, müssen Sie eine IPEndPoint mit der IP-Adresse und 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 mit einem 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.

Hinweis

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

Weitere Informationen

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

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

Die AddressFamily des IP-Protokolls.

Ausnahmen

ArgumentException

Der family-Parameter entspricht nicht AddressFamily.InterNetwork.

- oder -

Der family-Parameter entspricht nicht AddressFamily.InterNetworkV6.

Beispiele

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

TcpClient^ tcpClientD = gcnew TcpClient( AddressFamily::InterNetwork );

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Hinweise

Hinweis

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

TcpClient(String, Int32)

Quelle:

TCPClient.cs

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

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 eine Verbindung hergestellt werden soll.

port

Int32

Die Portnummer des Remotehosts, mit dem eine Verbindung hergestellt werden soll.

Ausnahmen

ArgumentNullException

Der hostname-Parameter ist null.

ArgumentOutOfRangeException

Der port-Parameter liegt nicht zwischen MinPort und MaxPort.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine instance der TcpClient -Klasse mithilfe eines Hostnamens und einer Portnummer erstellt wird.

// 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);

'Creates a TCPClient using hostname and port.

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

Hinweise

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

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

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Hinweis

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

Weitere Informationen

• TcpClient
• Connect(String, Int32)