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

TcpClient classe

 

Date de publication : novembre 2016

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

Libère les ressources managées et non managées utilisées par le TcpClient.

System_CAPS_protmethod Dispose(Boolean)

Libère les ressources non managées utilisées par 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 T:System.Net.Sockets.TcpClient class provides simple methods for connecting, sending, and receiving stream data over a network in synchronous blocking mode.

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

  • Create a T:System.Net.Sockets.TcpClient and call one of the three available M:System.Net.Sockets.TcpClient.Connect(System.String,System.Int32) methods.

  • Create a T:System.Net.Sockets.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 T:System.Net.Sockets.UdpClient class.

Remarques à l’attention des héritiers :

To send and receive data, use the M:System.Net.Sockets.TcpClient.GetStream method to obtain a T:System.Net.Sockets.NetworkStream. Call the M:System.Net.Sockets.NetworkStream.Write(System.Byte[],System.Int32,System.Int32) and M:System.Net.Sockets.NetworkStream.Read(System.Byte[],System.Int32,System.Int32) methods of the T:System.Net.Sockets.NetworkStream to send and receive data with the remote host. Use the M:System.Net.Sockets.NetworkStream.Close(System.Int32) method to release all resources associated with the T:System.Net.Sockets.TcpClient.

The following code example establishes a T:System.Net.Sockets.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 publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début