TcpClient Constructeurs

Définition

Espace de noms:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Initialise une nouvelle instance de la classe TcpClient.

Surcharges

TcpClient()	Initialise une nouvelle instance de la classe TcpClient.
TcpClient(IPEndPoint)	Initialise une nouvelle instance de la classe TcpClient et la lie au point de terminaison local spécifié.
TcpClient(AddressFamily)	Initialise une nouvelle instance de la classe TcpClient avec la famille spécifiée.
TcpClient(String, Int32)	Initialise une nouvelle instance de la classe TcpClient et établit une connexion au port spécifié sur l'hôte spécifié.

TcpClient()

Source:

TCPClient.cs

Initialise une nouvelle instance de la classe TcpClient.

public:
 TcpClient();

public TcpClient ();

Public Sub New ()

Exemples

L’exemple de code suivant montre comment utiliser le constructeur sans paramètre pour créer un nouveau TcpClient.

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

Remarques

Ce constructeur crée un nouveau TcpClient et permet au fournisseur de services sous-jacent d’attribuer l’adresse IP locale et le numéro de port les plus appropriés. Vous devez d’abord appeler la Connect méthode avant d’envoyer et de recevoir des données.

Notes

Sur .NET Framework, ce constructeur fonctionne uniquement avec les types d’adresses IPv4.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

Voir aussi

• Connect(String, Int32)

TcpClient(IPEndPoint)

Source:

TCPClient.cs

Initialise une nouvelle instance de la classe TcpClient et la lie au point de terminaison local spécifié.

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)

Paramètres

localEP

IPEndPoint

L'élément IPEndPoint auquel vous liez l'élément Socket TCP.

Exceptions

ArgumentNullException

Le paramètre localEP a la valeur null.

Exemples

L’exemple de code suivant montre comment créer un instance de la classe à l’aide TcpClient d’un point de terminaison local.

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

Remarques

Ce constructeur crée un nouveau TcpClient et le lie au IPEndPoint spécifié par le localEP paramètre . Avant d’appeler ce constructeur, vous devez créer un à l’aide de IPEndPoint l’adresse IP et du numéro de port à partir desquels vous envisagez d’envoyer et de recevoir des données. Vous n’avez pas besoin de spécifier une adresse IP locale et un numéro de port avant de vous connecter et de communiquer. Si vous créez un à l’aide d’un TcpClient autre constructeur, le fournisseur de services sous-jacent attribuera l’adresse IP locale et le numéro de port les plus appropriés.

Vous devez appeler la Connect méthode avant d’envoyer et de recevoir des données.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

Voir aussi

• IPEndPoint
• Connect(String, Int32)

TcpClient(AddressFamily)

Source:

TCPClient.cs

Initialise une nouvelle instance de la classe TcpClient avec la famille spécifiée.

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)

Paramètres

family

AddressFamily

AddressFamily du protocole IP.

Exceptions

ArgumentException

Le paramètre family n'est pas égal à AddressFamily.InterNetwork.

- ou -

Le paramètre family n'est pas égal à AddressFamily.InterNetworkV6.

Exemples

L’exemple de code suivant montre comment créer une instance de la TcpClient classe.

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

TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);

Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)

Remarques

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

TcpClient(String, Int32)

Source:

TCPClient.cs

Initialise une nouvelle instance de la classe TcpClient et établit une connexion au port spécifié sur l'hôte spécifié.

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)

Paramètres

hostname

String

Nom DNS de l'hôte distant auquel vous voulez vous connecter.

port

Int32

Numéro de port de l'hôte distant auquel vous voulez vous connecter.

Exceptions

ArgumentNullException

Le paramètre hostname a la valeur null.

ArgumentOutOfRangeException

Le paramètre port n’est pas compris entre MinPort et MaxPort.

SocketException

Une erreur s’est produite pendant l’accès au socket.

Exemples

L’exemple de code suivant montre comment créer une instance de la classe à l’aide TcpClient d’un nom d’hôte et d’un numéro de port.

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

Remarques

Ce constructeur en crée un et TcpClient effectue une tentative de connexion synchrone au nom d’hôte et au numéro de port fournis. Le fournisseur de services sous-jacent attribue l’adresse IP locale et le numéro de port les plus appropriés. TcpClient bloquera jusqu’à ce qu’il se connecte ou échoue. Ce constructeur vous permet d’initialiser, de résoudre le nom d’hôte DNS et de vous connecter en une étape pratique.

Si IPv6 est activé et que la TcpClient(String, Int32) méthode est appelée pour se connecter à un hôte qui se résout en adresses IPv6 et IPv4, la connexion à l’adresse IPv6 est tentée avant l’adresse IPv4. Cela peut avoir pour effet de retarder le délai d’établissement de la connexion si l’hôte n’écoute pas l’adresse IPv6.

Notes

Si vous recevez un SocketException, utilisez SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, vous pouvez vous référer à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

Voir aussi

• TcpClient
• Connect(String, Int32)