NetTcpBinding Classe

Définition

Espace de noms:
System.ServiceModel
Assemblys:
System.ServiceModel.dll, System.ServiceModel.NetTcp.dll
Assembly:
System.ServiceModel.NetTcp.dll
Assembly:
System.ServiceModel.dll
Paquets:
System.ServiceModel.NetTcp v10.0.652802, System.ServiceModel.Primitives v10.0.652802
Paquet:
System.ServiceModel.NetTcp v10.0.652802
Source:
NetTcpBinding.cs
Source:
NetTcpBinding.cs
Source:
NetTcpBinding.cs

Liaison sécurisée et fiable adaptée à la communication entre ordinateurs.

public ref class NetTcpBinding : System::ServiceModel::Channels::Binding
public ref class NetTcpBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences
public class NetTcpBinding : System.ServiceModel.Channels.Binding
public class NetTcpBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
type NetTcpBinding = class
    inherit Binding
type NetTcpBinding = class
    inherit Binding
    interface IBindingRuntimePreferences
Public Class NetTcpBinding
Inherits Binding
Public Class NetTcpBinding
Inherits Binding
Implements IBindingRuntimePreferences
Héritage
Object
Binding
NetTcpBinding
Dérivé
Implémente
IBindingRuntimePreferences

Exemples

Cet exemple montre comment créer un NetTcpBinding, définir le mode de sécurité et le type d’informations d’identification de transport.

NetTcpBinding binding = new NetTcpBinding();
binding.Security.Mode = SecurityMode.Transport;
binding.Security.Transport.ClientCredentialType = TcpClientCredentialType.Certificate;

Remarques

La NetTcpBinding pile de communication au moment de l’exécution est générée par défaut, qui utilise la sécurité de transport, TCP pour la remise des messages et un encodage de message binaire. Cette liaison est un choix système fourni par Windows Communication Foundation (WCF) approprié pour communiquer sur un intranet.

La configuration par défaut est NetTcpBinding plus rapide que la configuration fournie par le service , mais elle est destinée uniquement à la WSHttpBindingcommunication WCF. Le comportement de sécurité est configurable à l’aide du paramètre facultatif securityMode dans le constructeur. L’utilisation de WS-ReliableMessaging est configurable à l’aide du paramètre facultatif reliableSessionEnabled . Mais la messagerie fiable est désactivée par défaut. Plus généralement, les liaisons fournies par le système HTTP, telles que WSHttpBinding et BasicHttpBinding configurées pour activer les éléments par défaut, tandis que la NetTcpBinding liaison désactive les éléments par défaut afin que vous deviez choisir d’obtenir la prise en charge, par exemple, pour l’une des spécifications WS-*. Cela signifie que la configuration par défaut pour TCP est plus rapide lors de l’échange de messages entre des points de terminaison que ceux configurés pour les liaisons HTTP par défaut.

Warning

Utilise NetTcpBinding le regroupement de connexions TCP en fonction du nom DNS hôte du service et du numéro de port sur lequel le service écoute. Cela fonctionne bien lorsqu’un client effectue des appels à différents services sur différents ports ou services sont hébergés dans un seul processus et partagent un port. Si un seul client appelle plusieurs services partageant un port hébergé dans différents processus, ou s’il est hébergé par WAS/IIS, le regroupement côté client peut entraîner des problèmes où une connexion au service A est réutilisée pour le service B, ce qui entraîne une exception levée, la connexion abandonnée et un nouveau canal créé. Pour éviter ce problème, utilisez customBinding et spécifiez un autre ConnectionPoolSettings.GroupName pour chaque service avec lequel le client communique.

Constructeurs

Nom Description
NetTcpBinding()

Initialise une nouvelle instance de la classe NetTcpBinding.
NetTcpBinding(SecurityMode, Boolean)

Initialise une nouvelle instance de la NetTcpBinding classe avec le type de sécurité utilisé et avec une valeur qui indique si les sessions fiables sont explicitement activées.
NetTcpBinding(SecurityMode)

Initialise une nouvelle instance de la NetTcpBinding classe avec le type de sécurité utilisé.
NetTcpBinding(String)

Initialise une nouvelle instance de la NetTcpBinding classe avec un nom de configuration spécifié.

Propriétés

Nom Description
CloseTimeout

Obtient ou définit l’intervalle de temps fourni pour une connexion à fermer avant que le transport déclenche une exception.

(Hérité de Binding)
EnvelopeVersion

Obtient la version de SOAP utilisée pour les messages traités par cette liaison.
HostNameComparisonMode

Obtient ou définit une valeur qui indique si le nom d’hôte est utilisé pour atteindre le service lors de la correspondance de l’URI.
ListenBacklog

Obtient ou définit le nombre maximal de demandes de connexion en file d’attente qui peuvent être en attente.
MaxBufferPoolSize

Obtient ou définit la taille maximale, en octets, autorisée pour un pool de mémoires tampons qui stocke les messages TCP traités par la liaison.
MaxBufferSize

Obtient ou définit une valeur qui spécifie la taille maximale, en octets, de la mémoire tampon utilisée pour stocker les messages en mémoire.
MaxConnections

Obtient ou définit une valeur qui contrôle le nombre maximal de connexions à regrouper pour une réutilisation ultérieure sur le client et le nombre maximal de connexions autorisées à être distribuées sur le serveur.
MaxReceivedMessageSize

Obtient ou définit la taille maximale, en octets, pour un message reçu traité par la liaison.
MessageVersion

Obtient la version du message utilisée par les clients et les services configurés avec la liaison.

(Hérité de Binding)
Name

Obtient ou définit le nom de la liaison.

(Hérité de Binding)
Namespace

Obtient ou définit l’espace de noms XML de la liaison.

(Hérité de Binding)
OpenTimeout

Obtient ou définit l’intervalle de temps fourni pour qu’une connexion s’ouvre avant que le transport déclenche une exception.

(Hérité de Binding)
PortSharingEnabled

Obtient ou définit une valeur qui indique si le partage de ports TCP est activé pour la connexion configurée avec cette liaison.
ReaderQuotas

Obtient ou définit des contraintes sur la complexité des messages SOAP qui peuvent être traités par les points de terminaison configurés avec cette liaison.
ReceiveTimeout

Obtient ou définit l’intervalle de temps pendant lequel une connexion peut rester inactive, pendant laquelle aucun message d’application n’est reçu, avant d’être supprimé.

(Hérité de Binding)
ReliableSession

Obtient un objet qui indique si une session fiable est établie entre les points de terminaison de canal.
Scheme

Retourne le schéma d’URI pour le transport.
Security

Obtient un objet qui spécifie le type de sécurité utilisé avec les services configurés avec cette liaison.
SendTimeout

Obtient ou définit l’intervalle de temps fourni pour qu’une opération d’écriture se termine avant que le transport déclenche une exception.

(Hérité de Binding)
TransactionFlow

Obtient ou définit une valeur qui détermine si le flux de transaction est activé.
TransactionProtocol

Obtient ou définit le protocole de transactions utilisé par le service pour effectuer des transactions de flux.
TransferMode

Obtient ou définit une valeur qui indique si le service configuré avec la liaison utilise des modes de transfert de messages en continu ou mis en mémoire tampon (ou les deux).

Méthodes

Nom Description
BuildChannelFactory<TChannel>(BindingParameterCollection)

Génère la pile de fabrique de canaux sur le client qui crée un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées par une collection de paramètres de liaison.

(Hérité de Binding)
BuildChannelFactory<TChannel>(Object[])

Génère la pile de fabrique de canaux sur le client qui crée un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées par un tableau d’objets.

(Hérité de Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)

Génère l’écouteur de canal sur le service qui accepte un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées par une collection de paramètres de liaison.

(Hérité de Binding)
BuildChannelListener<TChannel>(Object[])

Génère l’écouteur de canal sur le service qui accepte un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées.

(Hérité de Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Génère l’écouteur de canal sur le service qui accepte un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées.

(Hérité de Binding)
BuildChannelListener<TChannel>(Uri, Object[])

Génère l’écouteur de canal sur le service qui accepte un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées.

(Hérité de Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Génère l’écouteur de canal sur le service qui accepte un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées.

(Hérité de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Génère l’écouteur de canal sur le service qui accepte un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées.

(Hérité de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Génère l’écouteur de canal sur le service qui accepte un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées.

(Hérité de Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])

Génère l’écouteur de canal sur le service qui accepte un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées.

(Hérité de Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Retourne une valeur qui indique si la liaison actuelle peut générer une pile de fabriques de canaux sur le client qui satisfait à la collection de paramètres de liaison spécifié.

(Hérité de Binding)
CanBuildChannelFactory<TChannel>(Object[])

Retourne une valeur qui indique si la liaison actuelle peut générer une pile de fabriques de canaux sur le client qui répond aux exigences spécifiées par un tableau d’objets.

(Hérité de Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)

Retourne une valeur qui indique si la liaison actuelle peut générer une pile d’écouteurs de canal sur le service qui satisfait à la collection de paramètres de liaison spécifié.

(Hérité de Binding)
CanBuildChannelListener<TChannel>(Object[])

Retourne une valeur qui indique si la liaison actuelle peut générer une pile d’écouteurs de canal sur le service qui répond aux critères spécifiés dans un tableau d’objets.

(Hérité de Binding)
CreateBindingElements()

Crée une collection avec les éléments de liaison de la liaison.
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetProperty<T>(BindingParameterCollection)

Retourne un objet typé demandé, le cas échéant, à partir de la couche appropriée dans la pile de liaisons.

(Hérité de Binding)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ShouldSerializeListenBacklog()

Retourne une valeur qui indique si la ListenBacklog propriété a changé de sa valeur par défaut et doit être sérialisée.
ShouldSerializeMaxConnections()

Retourne une valeur qui indique si la MaxConnections propriété a changé de sa valeur par défaut et doit être sérialisée.
ShouldSerializeName()

Retourne si le nom de la liaison doit être sérialisé.

(Hérité de Binding)
ShouldSerializeNamespace()

Retourne si l’espace de noms de la liaison doit être sérialisé.

(Hérité de Binding)
ShouldSerializeReaderQuotas()

Retourne une valeur qui indique si la ReaderQuotas propriété a changé de sa valeur par défaut et doit être sérialisée.
ShouldSerializeReliableSession()

Retourne une valeur qui indique si la ReliableSession propriété a changé de sa valeur par défaut et doit être sérialisée.
ShouldSerializeSecurity()

Retourne une valeur qui indique si la Security propriété a changé de sa valeur par défaut et doit être sérialisée.
ShouldSerializeTransactionProtocol()

Retourne une valeur qui indique si la TransactionProtocol propriété a changé de sa valeur par défaut et doit être sérialisée.
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

Nom Description
IBindingRuntimePreferences.ReceiveSynchronously

Obtient une valeur qui indique si les requêtes entrantes sont gérées de manière synchrone ou asynchrone.

S’applique à