NetTcpBinding Classe

  • Référence

Définition

Espace de noms:
System.ServiceModel
Assembly:
System.ServiceModel.NetTcp.dll
Assembly:
System.ServiceModel.dll

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 approprié Windows Communication Foundation (WCF) fourni par le système pour communiquer sur un intranet.

La configuration par défaut est NetTcpBinding plus rapide que la configuration fournie par le , mais elle est destinée uniquement à la WSHttpBindingcommunication WCF. Le comportement de sécurité peut être configuré à l'aide du paramètre securityMode en option dans le constructeur. L'utilisation de WS-ReliableMessaging peut être configurée à l'aide du paramètre reliableSessionEnabled facultatif. Mais les fonctionnalités de messagerie fiable sont désactivées par défaut. Plus généralement, les liaisons fournies par le système HTTP telles que WSHttpBinding et BasicHttpBinding sont configurées pour activer certains éléments par défaut, alors que la liaison NetTcpBinding en désactive par défaut. Par conséquent, vous devez demander de l’aide explicitement, par exemple pour les spécifications WS - *. Cela signifie que la configuration TCP par défaut permet d'échanger des messages entre points de terminaison plus rapidement que celle configurée par défaut pour les liaisons HTTP.

Avertissement

Il NetTcpBinding utilise 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 client unique appelle plusieurs services qui partagent un port hébergé dans différents processus ou sont hébergés 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 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 un CustomBinding et spécifiez un autre ConnectionPoolSettings.GroupName pour chaque service avec lequel le client communique.

Constructeurs

NetTcpBinding()

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

Initialise une nouvelle instance de la classe NetTcpBinding avec spécification du type de sécurité utilisé.
NetTcpBinding(SecurityMode, Boolean)

Initialise une nouvelle instance de la classe NetTcpBinding avec spécification du type de sécurité utilisé ainsi qu'une valeur indiquant si les sessions fiables sont activées de façon explicite.
NetTcpBinding(String)

Initialise une nouvelle instance de la classe NetTcpBinding disposant d'un nom de configuration spécifié.

Propriétés

CloseTimeout

Obtient ou définit l'intervalle de temps attribué à une connexion pour qu'elle se ferme avant que le transport lève 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 avec l'URI.
ListenBacklog

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

Obtient ou définit la taille maximale (en octets) autorisée d'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 des 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 ainsi que le nombre maximal de connexions en attente de distribution autorisées sur le serveur.
MaxReceivedMessageSize

Obtient ou définit la taille maximale (en octets) d'un message reçu qui est traité par la liaison.
MessageVersion

Obtient la version de 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 attribué à une connexion pour qu'elle s'ouvre avant que le transport lève une exception.

(Hérité de Binding)
PortSharingEnabled

Obtient ou définit une valeur qui spécifie 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 pouvant être traités par les points de terminaison configurés avec cette liaison.
ReceiveTimeout

Obtient ou définit la durée d’inactivité d’une connexion. Si aucun message d’application n’est reçu pendant ce laps de temps, la connexion est abandonnée.

(Hérité de Binding)
ReliableSession

Obtient un objet qui indique si une session fiable est établie entre les points de terminaison du 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 attribué à une opération d'écriture pour qu'elle se termine avant que le transport lève une exception.

(Hérité de Binding)
TransactionFlow

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

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

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

Méthodes

BuildChannelFactory<TChannel>(BindingParameterCollection)

Génère la pile de fabriques de canaux sur le client qui crée un type de canal donné et est conforme 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 fabriques de canaux sur le client qui crée un type de canal donné et est conforme 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 donné et est conforme 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 donné et est conforme 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 donné et est conforme 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 donné et est conforme 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 donné et est conforme 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 donné et est conforme 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 donné et est conforme 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 donné et est conforme 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 sur le client une pile de fabriques de canaux conforme à la collection de paramètres de liaison spécifiée.

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

Retourne une valeur qui indique si la liaison actuelle peut générer sur le client une pile de fabriques de canaux conforme aux exigences définies 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 sur le service une pile d’écouteurs de canal conforme à la collection de paramètres de liaison spécifiée.

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

Retourne une valeur qui indique si la liaison actuelle peut générer sur le service une pile d’écouteurs de canal conforme 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 pour la liaison.
Equals(Object)

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

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

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

Retourne un objet typé demandé (s’il existe) à partir de la couche appropriée dans la pile de liaison.

(Hérité de Binding)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ShouldSerializeListenBacklog()

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

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

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

(Hérité de Binding)
ShouldSerializeNamespace()

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

(Hérité de Binding)
ShouldSerializeReaderQuotas()

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

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

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

Retourne une valeur qui indique si la propriété TransactionProtocol utilise une autre valeur que 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

IBindingRuntimePreferences.ReceiveSynchronously

Obtient une valeur qui indique si les demandes entrantes sont gérées de façon synchrone ou asynchrone.

S’applique à