Comment : personnaliser une liaison fournie par le système
Windows Communication Foundation (WCF) inclut plusieurs liaisons fournies par le système qui vous permettent de configurer quelques-unes des propriétés des éléments de liaison sous-jacents, mais pas toutes les propriétés. Cette rubrique explique comment attribuer des propriétés aux éléments de liaison afin de créer une liaison personnalisée.
Pour plus d'informations sur la façon de créer et de configurer directement des éléments de liaison sans utiliser les liaisons fournies par le système, consultez Liaisons personnalisées.
Pour plus d'informations sur la création et l'extension des liaisons personnalisées, consultez Extension de liaisons.
Dans WCF, toutes les liaisons sont composées d'éléments de liaison. Chaque élément de liaison dérive de la classe BindingElement. Les liaisons fournies par le système telles que BasicHttpBinding créent et configurent leurs propres éléments de liaison. Cette rubrique vous indique comment accéder aux propriétés de ces éléments de liaison qui ne sont pas exposés directement sur la liaison et comment les modifier ; il s'agit, notamment, de la classe BasicHttpBinding.
Les éléments de liaison individuels sont inclus dans une collection représentée par la classe BindingElementCollection et sont ajoutés dans l'ordre suivant : Transaction Flow, Reliable Session, Security, Composite Duplex, One-way, Stream Security, Message Encoding et Transport. Notez que les éléments de liaison répertoriés ne sont pas tous requis dans chaque liaison. Les éléments de liaison définis par l'utilisateur peuvent également apparaître dans cette collection et doivent figurer dans le même ordre que précédemment. Par exemple, un transport défini par l'utilisateur doit être le dernier élément de la collection d'éléments de liaison.
La classe BasicHttpBinding contient trois éléments de liaison :
- Un élément de liaison de sécurité facultatif, soit la classe AsymmetricSecurityBindingElement utilisée avec le transport HTTP (sécurité de niveau transport), soit la classe TransportSecurityBindingElement utilisée lorsque la couche transport fournit la sécurité, auquel cas le transport HTTPS est utilisé.
- Un élément de liaison de codeur de message requis, TextMessageEncodingBindingElement ou MtomMessageEncodingBindingElement.
- Un élément de liaison de transport requis, HttpTransportBindingElement, ou HttpsTransportBindingElement.
Dans cet exemple nous allons créer une instance de la liaison, générer une liaison personnalisée à partir de là, examiner les éléments de liaison dans la liaison personnalisée et, lorsque nous aurons trouvé l'élément de liaison HTTP, affecter à sa propriété KeepAliveEnabled la valeur false. La propriété KeepAliveEnabled n'est pas exposée directement sur BasicHttpBinding, nous devons donc créer une liaison personnalisée pour naviguer jusqu'à l'élément de liaison et définir cette propriété.
Pour modifier une liaison fournie par le système
Créez une instance de la classe BasicHttpBinding et affectez à son mode de sécurité la valeur de sécurité au niveau du message.
Créez une liaison personnalisée à partir de la liaison et ensuite une classe BindingElementCollection à partir de l'une des propriétés de la liaison personnalisée.
Parcourez la classe BindingElementCollection et lorsque vous trouverez la classe HttpTransportBindingElement, affectez à sa propriété KeepAliveEnabled la valeur false.
Voir aussi
Référence
HttpTransportBindingElement
BasicHttpBinding
CustomBinding