TcpClient Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de la classe TcpClient.
Surcharges
| Nom | Description |
|---|---|
| TcpClient() |
Initialise une nouvelle instance de la classe TcpClient. |
| TcpClient(IPEndPoint) |
Initialise une nouvelle instance de la TcpClient classe et la lie au point de terminaison local spécifié. |
| TcpClient(AddressFamily) |
Initialise une nouvelle instance de la TcpClient classe avec la famille spécifiée. |
| TcpClient(String, Int32) |
Initialise une nouvelle instance de la TcpClient classe et se connecte au port spécifié sur l’hôte spécifié. |
TcpClient()
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 = new TcpClient ();
'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient
Remarques
Ce constructeur crée un nouveau TcpClient fournisseur de services sous-jacent 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.
Note
Sur .NET Framework, ce constructeur fonctionne uniquement avec les types d’adresses IPv4.
Note
Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.
Voir aussi
S’applique à
TcpClient(IPEndPoint)
Initialise une nouvelle instance de la TcpClient classe 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
IPEndPoint Auquel vous liez le TCP Socket.
Exceptions
Le localEP paramètre est null.
Exemples
L’exemple de code suivant montre comment créer une instance de la classe à l’aide TcpClient d’un point de terminaison local.
//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 constructeur et le lie au IPEndPoint paramètre spécifié localEP . Avant d’appeler ce constructeur, vous devez créer une IPEndPoint adresse IP et un numéro de port à partir desquels vous avez l’intention 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 TcpClient constructeur à l’aide d’un autre constructeur, le fournisseur de services sous-jacent affecte l’adresse IP locale et le numéro de port les plus appropriés.
Vous devez appeler la méthode avant d’envoyer Connect et de recevoir des données.
Note
Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.
Voir aussi
S’applique à
TcpClient(AddressFamily)
Initialise une nouvelle instance de la TcpClient classe 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
Protocole AddressFamily IP.
Exceptions
Le family paramètre n’est pas égal à AddressFamily.InterNetwork
-ou-
Le family paramètre n’est pas égal à AddressFamily.InterNetworkV6
Exemples
L’exemple de code suivant montre comment créer une instance de la TcpClient classe.
TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);
Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)
Remarques
Note
Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.
S’applique à
TcpClient(String, Int32)
Initialise une nouvelle instance de la TcpClient classe et se connecte 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 envisagez de vous connecter.
- port
- Int32
Numéro de port de l’hôte distant auquel vous envisagez de vous connecter.
Exceptions
Le hostname paramètre est null.
Une erreur s’est produite lors de 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 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 crée une nouvelle TcpClient connexion et effectue une tentative de connexion synchrone au nom d’hôte et au numéro de port fournis. Le fournisseur de services sous-jacent affecte 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 aux adresses IPv6 et IPv4, la connexion à l’adresse IPv6 est tentée en premier 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 sur l’adresse IPv6.
Note
Si vous recevez un SocketException, utilisez-le SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, vous pouvez consulter la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.
Note
Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.