Durée (Heure normale du Pacifique):
À (Heure normale du Pacifique):
Impact:
  • None
Action de l'utilisateur :
  • None

TcpClient, classe

 

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

Espace de noms:   System.Net.Sockets
Assembly:  System (dans System.dll)

System.Object
  System.Net.Sockets.TcpClient

Public Class TcpClient
	Implements IDisposable
Nom Description
System_CAPS_pubmethod TcpClient()

Initialise une nouvelle instance de la classe TcpClient.

System_CAPS_pubmethod TcpClient(AddressFamily)

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

System_CAPS_pubmethod TcpClient(IPEndPoint)

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

System_CAPS_pubmethod 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é.

Nom Description
System_CAPS_protproperty Active

Obtient ou définit une valeur indiquant si une connexion a été établie.

System_CAPS_pubproperty Available

Obtient la quantité de données reçues du réseau et disponibles pour la lecture.

System_CAPS_pubproperty Client

Obtient ou définit l'élément Socket sous-jacent.

System_CAPS_pubproperty Connected

Obtient une valeur indiquant si l'élément Socket sous-jacent d'un élément TcpClient est connecté à un hôte distant.

System_CAPS_pubproperty ExclusiveAddressUse

Obtient ou définit une valeur Boolean qui spécifie si l'élément TcpClient n'autorise qu'un seul client à utiliser un port.

System_CAPS_pubproperty LingerState

Obtient ou définit des informations relatives à l'état de persistance du socket associé.

System_CAPS_pubproperty NoDelay

Obtient ou définit une valeur qui désactive un délai de temporisation quand les mémoires tampons d'envoi ou de réception ne sont pas saturées.

System_CAPS_pubproperty ReceiveBufferSize

Obtient ou définit la taille de la mémoire tampon de réception.

System_CAPS_pubproperty ReceiveTimeout

Obtient ou définit la durée pendant laquelle un élément TcpClient attendra de recevoir des données une fois qu'une opération de lecture est initialisée.

System_CAPS_pubproperty SendBufferSize

Obtient ou définit la taille de la mémoire tampon d'envoi.

System_CAPS_pubproperty SendTimeout

Obtient ou définit la durée pendant laquelle un élément TcpClient attendra qu'une opération d'envoi se termine correctement.

Nom Description
System_CAPS_pubmethod 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 élément IPAddress et un numéro de port (Int32).

System_CAPS_pubmethod 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).

System_CAPS_pubmethod 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).

System_CAPS_pubmethod Close()

Supprime cette instance de TcpClient et demande que la connexion TCP sous-jacente soit fermée.

System_CAPS_pubmethod 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.

System_CAPS_pubmethod 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.

System_CAPS_pubmethod Connect(IPEndPoint)

Connecte le client à un hôte TCP distant en utilisant le point de terminaison réseau distant spécifié.

System_CAPS_pubmethod Connect(String, Int32)

Connecte le client au port spécifié sur l'hôte spécifié.

System_CAPS_pubmethod 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.

System_CAPS_pubmethod 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.

System_CAPS_pubmethod ConnectAsync(String, Int32)

Connecte le client au port TCP spécifié sur l'hôte spécifié sous forme d'opération asynchrone.

System_CAPS_pubmethod Dispose()

System_CAPS_protmethod Dispose(Boolean)

Libère les ressources non managées utilisées par l'objet TcpClient et libère éventuellement les ressources managées.

System_CAPS_pubmethod EndConnect(IAsyncResult)

Met fin à une tentative de connexion asynchrone en attente.

System_CAPS_pubmethod Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethod Finalize()

Libère les ressources utilisées par la classe TcpClient.(Remplace Object.Finalize().)

System_CAPS_pubmethod GetHashCode()

Fait office de fonction de hachage par défaut. (Hérité de Object.)

System_CAPS_pubmethod GetStream()

Retourne l'élément NetworkStream utilisé pour l'envoi et la réception de données.

System_CAPS_pubmethod GetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethod MemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethod ToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

The TcpClient class provides simple methods for connecting, sending, and receiving stream data over a network in synchronous blocking mode.

In order for TcpClient to connect and exchange data, a TcpListener or Socket created with the TCP ProtocolType must be listening for incoming connection requests. You can connect to this listener in one of the following two ways:

  • Create a TcpClient and call one of the three available Connect methods.

  • Create a TcpClient using the host name and port number of the remote host. This constructor will automatically attempt a connection.

System_CAPS_note Remarque

If you want to send connectionless datagrams in synchronous blocking mode, use the UdpClient class.

Remarques à l'attention des héritiers :

To send and receive data, use the GetStream method to obtain a NetworkStream.Call the Write and Read methods of the NetworkStream to send and receive data with the remote host.Use the Close method to release all resources associated with the TcpClient.

The following code example establishes a TcpClient connection.

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
SocketPermission

Permission to establish an outgoing connection or accept an incoming request.

.NET Framework
Disponible depuis 1.1

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début