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 le sujet suivant 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 le sujet suivant 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 :

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

2. Un élément de liaison d'encodeur de message requis, TextMessageEncodingBindingElement ou MtomMessageEncodingBindingElement.

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

1. Créez une instance de la classe BasicHttpBinding et affectez à son mode de sécurité la valeur de sécurité au niveau du message.

   '  Create an instance of the T:System.ServiceModel.BasicHttpBinding 
   '  class and set its security mode to message-level security.
   Dim binding As New BasicHttpBinding()
   With binding.Security
       .Message.ClientCredentialType = BasicHttpMessageCredentialType.Certificate
       .Mode = BasicHttpSecurityMode.Message
   End With
   

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

   '  Create a custom binding from the binding 
   Dim cb As New CustomBinding(binding)
   '  Get the BindingElementCollection from this custom binding 
   Dim bec = cb.Elements
   

3. Parcourez la classe BindingElementCollection et lorsque vous trouverez la classe HttpTransportBindingElement, affectez à sa propriété KeepAliveEnabled la valeur false.

   '  Loop through the collection, and when you find the HTTP binding element
   '  set its KeepAliveEnabled property to false
   For Each be In bec
       Dim thisType = be.GetType()
       Console.WriteLine(thisType)
       If TypeOf be Is HttpTransportBindingElement Then
           Dim httpElement As HttpTransportBindingElement = CType(be, HttpTransportBindingElement)
           Console.WriteLine(Constants.vbTab & "Before: HttpTransportBindingElement.KeepAliveEnabled = {0}", httpElement.KeepAliveEnabled)
           httpElement.KeepAliveEnabled = False
           Console.WriteLine(vbTab & "After:  HttpTransportBindingElement.KeepAliveEnabled = {0}", httpElement.KeepAliveEnabled)
       End If
   Next be
   

Voir aussi

Référence

HttpTransportBindingElement
BasicHttpBinding
CustomBinding

Concepts

Liaisons personnalisées