Durée (Heure normale du Pacifique):
À (Heure normale du Pacifique):
Impact:
  • None
Action de l'utilisateur :
  • None
Bibliothèque de classes .NET Framework

TcpClient, classe

Fournit des connexions clientes pour les services réseau TCP.

System.Object
  System.Net.Sockets.TcpClient

Espace de noms :  System.Net.Sockets
Assembly :  System (dans System.dll)
Public Class TcpClient _
	Implements IDisposable

Le type TcpClient expose les membres suivants.

  Nom Description
Méthode publique TcpClient() Initialise une nouvelle instance de la classe TcpClient.
Méthode publique TcpClient(AddressFamily) Initialise une nouvelle instance de la classe TcpClient avec la famille spécifiée.
Méthode publique TcpClient(IPEndPoint) Initialise une nouvelle instance de la classe TcpClient et la lie au point de terminaison local spécifié.
Méthode publique 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é.
Début
  Nom Description
Propriété protégée Active Obtient ou définit une valeur indiquant si une connexion a été établie.
Propriété publique Available Obtient la quantité de données reçues du réseau et disponibles pour la lecture.
Propriété publique Client Obtient ou définit le Socket sous-jacent.
Propriété publique Connected Obtient une valeur indiquant si le Socket sous-jacent de TcpClient est connecté à un hôte distant.
Propriété publique ExclusiveAddressUse Obtient ou définit une valeur Boolean qui spécifie si TcpClient n'autorise qu'un seul client à utiliser un port.
Propriété publique LingerState Obtient ou définit les informations relatives à l'état de maintien du socket associé.
Propriété publique NoDelay Obtient ou définit une valeur qui désactive un délai de temporisation lorsque les mémoires tampons d'envoi ou de réception ne sont pas saturées.
Propriété publique ReceiveBufferSize Obtient ou définit la taille de la mémoire tampon de réception.
Propriété publique ReceiveTimeout Obtient ou définit la durée pendant laquelle TcpClient attendra de recevoir des données une fois l'opération de lecture initialisée.
Propriété publique SendBufferSize Obtient ou définit la taille de la mémoire tampon d'envoi.
Propriété publique SendTimeout Obtient ou définit la durée pendant laquelle TcpClient attendra qu'une opération d'envoi se termine correctement.
Début
  Nom Description
Méthode publique BeginConnect(IPAddress, Int32, AsyncCallback, Object) Démarre une demande asynchrone pour une connexion d'hôte distant. L'hôte distant est spécifié par IPAddress et un numéro de port (Int32).
Méthode publique BeginConnect(IPAddress[], Int32, AsyncCallback, Object) Démarre une demande asynchrone pour une connexion d'hôte distant. L'hôte distant est spécifié par un tableau IPAddress et un numéro de port (Int32).
Méthode publique BeginConnect(String, Int32, AsyncCallback, Object) Démarre une demande asynchrone pour une connexion d'hôte distant. L'hôte distant est spécifié par un nom d'hôte (String) et un numéro de port (Int32).
Méthode publique Close Supprime cette instance de TcpClient et demande que la connexion TCP sous-jacente soit fermée.
Méthode publique Connect(IPEndPoint) Connecte le client à un hôte TCP distant en utilisant le point de terminaison réseau distant spécifié.
Méthode publique Connect(IPAddress, Int32) Connecte le client à un hôte TCP distant en utilisant l'adresse IP et le numéro de port spécifiés.
Méthode publique Connect(IPAddress[], Int32) Connecte le client à un hôte TCP distant en utilisant les adresses IP et le numéro de port spécifiés.
Méthode publique Connect(String, Int32) Connecte le client au port spécifié sur l'hôte spécifié.
Méthode publique ConnectAsync(IPAddress, Int32) Connecte le client à un hôte TCP distant en utilisant l'adresse IP et le numéro de port spécifiés sous forme d'opération asynchrone.
Méthode publique ConnectAsync(IPAddress[], Int32) Connecte le client à un hôte TCP distant en utilisant les adresses IP et le numéro de port spécifiés sous forme d'opération asynchrone.
Méthode publique ConnectAsync(String, Int32) Connecte le client au port TCP spécifié sur l'hôte spécifié en tant qu'opération asynchrone.
Méthode protégée Dispose Libère les ressources non managées utilisées par TcpClient et libère éventuellement les ressources managées.
Méthode publique EndConnect Met fin à une tentative de connexion asynchrone en attente.
Méthode publique Equals(Object) Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégée Finalize Libère les ressources utilisées par la classe TcpClient. (Substitue Object.Finalize().)
Méthode publique GetHashCode Sert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publique GetStream Retourne le NetworkStream utilisé pour l'envoi et la réception de données.
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publique ToString Retourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Début
  Nom Description
Implémentation d'interface explicite Méthode privée IDisposable.Dispose Infrastructure. Libère toutes les ressources utilisées par TcpClient.
Début

La classe TcpClient fournit des méthodes simples de connexion, d'envoi et de réception de flux de données sur un réseau en mode blocage synchrone.

Afin que TcpClient puisse se connecter et échanger des données, un TcpListener ou un Socket créé à l'aide du ProtocolType TCP doit être à l'écoute des demandes de connexion entrantes. Vous pouvez vous connecter à cet écouteur des deux manières suivantes :

  • Créer TcpClient et appeler une des trois méthodes Connect disponibles.

  • Créer TcpClient à l'aide du nom d'hôte et du numéro de port de l'hôte distant. Ce constructeur tentera automatiquement d'établir une connexion.

Remarque Remarque

Si vous voulez envoyer des datagrammes sans connexion en mode blocage synchrone, utilisez la classe UdpClient.

Remarques à l'attention des héritiers

Pour envoyer et recevoir des données, utilisez la méthode GetStream pour obtenir NetworkStream. Appelez les méthodes Write et Read de NetworkStream pour envoyer et recevoir des données avec l'hôte distant. Utilisez la méthode Close pour libérer toutes les ressources associées à TcpClient.

L'exemple de code suivant établit une connexion TcpClient.


Shared Sub Connect(server As [String], message As [String])
   Try
      ' Create a TcpClient.
      ' Note, for this client to work you need to have a TcpServer 
      ' connected to the same address as specified by the server, port
      ' combination.
      Dim port As Int32 = 13000
      Dim client As New TcpClient(server, port)

      ' Translate the passed message into ASCII and store it as a Byte array.
      Dim data As [Byte]() = System.Text.Encoding.ASCII.GetBytes(message)

      ' Get a client stream for reading and writing.
      '  Stream stream = client.GetStream();
      Dim stream As NetworkStream = client.GetStream()

      ' Send the message to the connected TcpServer. 
      stream.Write(data, 0, data.Length)

      Console.WriteLine("Sent: {0}", message)

      ' Receive the TcpServer.response.
      ' Buffer to store the response bytes.
      data = New [Byte](256) {}

      ' String to store the response ASCII representation.
      Dim responseData As [String] = [String].Empty

      ' Read the first batch of the TcpServer response bytes.
      Dim bytes As Int32 = stream.Read(data, 0, data.Length)
      responseData = System.Text.Encoding.ASCII.GetString(data, 0, bytes)
      Console.WriteLine("Received: {0}", responseData)

      ' Close everything.
      stream.Close()
      client.Close()
   Catch e As ArgumentNullException
      Console.WriteLine("ArgumentNullException: {0}", e)
   Catch e As SocketException
      Console.WriteLine("SocketException: {0}", e)
   End Try

   Console.WriteLine(ControlChars.Cr + " Press Enter to continue...")
   Console.Read()
End Sub 'Connect


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1
  • SocketPermission  

    Autorisation d'établir une connexion sortante ou d'accepter une demande entrante.

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.