Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

WSHttpBinding classe

 

Date de publication : novembre 2016

Représente une liaison interopérable qui prend en charge les transactions distribuées et les sessions fiables et sécurisées.

Espace de noms:   System.ServiceModel
Assembly:  System.ServiceModel (dans System.ServiceModel.dll)


public class WSHttpBinding : WSHttpBindingBase

NomDescription
System_CAPS_pubmethodWSHttpBinding()

Initialise une nouvelle instance de la classe WSHttpBinding.

System_CAPS_pubmethodWSHttpBinding(SecurityMode)

Initialise une nouvelle instance de la classe WSHttpBinding avec un type spécifié de sécurité utilisé par la liaison.

System_CAPS_pubmethodWSHttpBinding(SecurityMode, Boolean)

Initialise une nouvelle instance de la classe WSHttpBinding avec un type spécifié de sécurité utilisé par la liaison et une valeur indiquant si une session fiable est activée.

System_CAPS_pubmethodWSHttpBinding(String)

Initialise une nouvelle instance de la classe WSHttpBinding avec une liaison spécifiée par son nom de configuration.

NomDescription
System_CAPS_pubpropertyAllowCookies

Obtient ou définit une valeur qui indique si le client WCF sera automatiquement stocker et renvoyer les cookies envoyés par un seul service web.

System_CAPS_pubpropertyBypassProxyOnLocal

Obtient ou définit une valeur qui indique si le serveur proxy doit être contourné pour les adresses locales.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyCloseTimeout

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

System_CAPS_pubpropertyEnvelopeVersion

Obtient la version de SOAP utilisée pour les messages traités par cette liaison.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyHostNameComparisonMode

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.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyMaxBufferPoolSize

Obtient ou définit la quantité maximale de mémoire allouée, en octets, pour le Gestionnaire de tampons qui gère les mémoires tampons requises par les points de terminaison à l’aide de cette liaison.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyMaxReceivedMessageSize

Obtient ou définit la taille maximale, en octets, d’un message pouvant être traités par la liaison.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyMessageEncoding

Obtient ou définit si MTOM ou Text/XML est utilisé pour encoder les messages SOAP.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyMessageVersion

Obtient la version de message utilisée par les clients et les services configurés avec la liaison.(Hérité de Binding.)

System_CAPS_pubpropertyName

Obtient ou définit le nom de la liaison.(Hérité de Binding.)

System_CAPS_pubpropertyNamespace

Obtient ou définit l’espace de noms XML de la liaison.(Hérité de Binding.)

System_CAPS_pubpropertyOpenTimeout

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

System_CAPS_pubpropertyProxyAddress

Obtient ou définit l'adresse URI du proxy HTTP.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyReaderQuotas

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.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyReceiveTimeout

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

System_CAPS_pubpropertyReliableSession

Obtient un objet fournissant un accès aisé aux propriétés d’un élément de liaison de session fiable disponibles lors de l’utilisation d’une des liaisons fournies par le système.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyScheme

Obtient le schéma de transport URI pour les canaux et les écouteurs configurés avec cette liaison.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertySecurity

Obtient les paramètres de sécurité utilisés avec cette liaison.

System_CAPS_pubpropertySendTimeout

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

System_CAPS_pubpropertyTextEncoding

Obtient ou définit l'encodage de caractères utilisé pour le texte du message.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyTransactionFlow

Obtient ou définit une valeur indiquant si la liaison doit prendre en charge le flux WS-Transactions.(Hérité de WSHttpBindingBase.)

System_CAPS_pubpropertyUseDefaultWebProxy

Obtient ou définit une valeur qui indique si le proxy HTTP du système configuré automatiquement doit être utilisé, s'il est disponible.(Hérité de WSHttpBindingBase.)

NomDescription
System_CAPS_pubmethodBuildChannelFactory<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.(Remplace Binding.BuildChannelFactory<TChannel>(BindingParameterCollection).)

System_CAPS_pubmethodBuildChannelFactory<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.)

System_CAPS_pubmethodBuildChannelListener<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.)

System_CAPS_pubmethodBuildChannelListener<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.)

System_CAPS_pubmethodBuildChannelListener<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.)

System_CAPS_pubmethodBuildChannelListener<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.)

System_CAPS_pubmethodBuildChannelListener<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.)

System_CAPS_pubmethodBuildChannelListener<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.)

System_CAPS_pubmethodBuildChannelListener<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.)

System_CAPS_pubmethodBuildChannelListener<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.)

System_CAPS_pubmethodCanBuildChannelFactory<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.)

System_CAPS_pubmethodCanBuildChannelFactory<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.)

System_CAPS_pubmethodCanBuildChannelListener<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.)

System_CAPS_pubmethodCanBuildChannelListener<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.)

System_CAPS_pubmethodCreateBindingElements()

Renvoie une collection ordonnée d’éléments de liaison contenus dans la liaison actuelle.(Remplace WSHttpBindingBase.CreateBindingElements().)

System_CAPS_protmethodCreateMessageSecurity()

Retourne l’élément de liaison de sécurité de la liaison actuelle.(Remplace WSHttpBindingBase.CreateMessageSecurity().)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetProperty<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.)

System_CAPS_protmethodGetTransport()

Retourne l’élément de liaison de transport de la liaison actuelle.(Remplace WSHttpBindingBase.GetTransport().)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodShouldSerializeName()

Retourne une valeur indiquant si le nom de la liaison doit être sérialisé.(Hérité de Binding.)

System_CAPS_pubmethodShouldSerializeNamespace()

Retourne une valeur indiquant si l’espace de noms de la liaison doit être sérialisé.(Hérité de Binding.)

System_CAPS_pubmethodShouldSerializeReaderQuotas()

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.(Hérité de WSHttpBindingBase.)

System_CAPS_pubmethodShouldSerializeReliableSession()

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.(Hérité de WSHttpBindingBase.)

System_CAPS_pubmethodShouldSerializeSecurity()

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.

System_CAPS_pubmethodShouldSerializeTextEncoding()

Retourne une valeur qui indique si la propriété TextEncoding utilise une autre valeur que sa valeur par défaut et doit être sérialisée.(Hérité de WSHttpBindingBase.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privpropertyIBindingRuntimePreferences.ReceiveSynchronously

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

WSHttpBinding est semblable à BasicHttpBinding mais fournit plus de fonctionnalités de service Web. Il utilise le transport HTTP et assure la sécurité des messages, comme BasicHttpBinding, mais il fournit également des transactions, une messagerie fiable et WS-Addressing, qu'il soit actif par défaut ou disponible par l'intermédiaire d'un paramètre de contrôle unique.

L'exemple de code suivant montre comment utiliser la classe WSHttpBinding.

using System;
using System.ServiceModel;
using System.Collections.Generic;
using System.IdentityModel.Tokens;
using System.Security.Cryptography.X509Certificates;
using System.ServiceModel.Channels;
using System.ServiceModel.Security;
using System.ServiceModel.Security.Tokens;
using System.Security.Permissions;

// Define a service contract for the calculator. 
[ServiceContract()]
public interface ICalculator
{
    [OperationContract(IsOneWay = false)]
    double Add(double n1, double n2);
    [OperationContract(IsOneWay = false)]
    double Subtract(double n1, double n2);
    [OperationContract(IsOneWay = false)]
    double Multiply(double n1, double n2);
    [OperationContract(IsOneWay = false)]
    double Divide(double n1, double n2);
}

public sealed class CustomBindingCreator
{

    public static void snippetSecurity()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        WSHttpSecurity whSecurity = wsHttpBinding.Security;
    }


    public static void snippetCreateBindingElements()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        BindingElementCollection beCollection = wsHttpBinding.CreateBindingElements();
    }


    private void snippetCreateMessageSecurity()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        // SecurityBindingElement sbe = wsHttpBinding
    }

    public static void snippetGetTransport()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        //		TransportBindingElement tbElement = wsHttpBinding.GetTransport();
    }

    public static void snippetAllowCookies()
    {
        WSHttpBinding wsHttpBinding = new WSHttpBinding();
        wsHttpBinding.AllowCookies = true;
    }

    public static Binding GetBinding()
    {
        // securityMode is Message
        // reliableSessionEnabled is true
        WSHttpBinding binding = new WSHttpBinding(SecurityMode.Message, true);
        binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows;

        WSHttpSecurity security = binding.Security;
        return binding;

    }

    public static Binding GetBinding2()
    {

        // The security mode is set to Message.
        WSHttpBinding binding = new WSHttpBinding(SecurityMode.Message);
        binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows;
        return binding;

    }

    // This method creates a WSFederationHttpBinding.
    public static WSFederationHttpBinding CreateWSFederationHttpBinding()
    {
        // Create an instance of the WSFederationHttpBinding
        WSFederationHttpBinding b = new WSFederationHttpBinding();

        // Set the security mode to Message
        b.Security.Mode = WSFederationHttpSecurityMode.Message;

        // Set the Algorithm Suite to Basic256Rsa15
        b.Security.Message.AlgorithmSuite = SecurityAlgorithmSuite.Basic256Rsa15;

        // Set NegotiateServiceCredential to true
        b.Security.Message.NegotiateServiceCredential = true;

        // Set IssuedKeyType to Symmetric
        b.Security.Message.IssuedKeyType = SecurityKeyType.SymmetricKey;

        // Set IssuedTokenType to SAML 1.1
        b.Security.Message.IssuedTokenType = "http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#samlv1.1";

        // Extract the STS certificate from the certificate store
        X509Store store = new X509Store(StoreName.TrustedPeople, StoreLocation.CurrentUser);
        store.Open(OpenFlags.ReadOnly);
        X509Certificate2Collection certs = store.Certificates.Find(X509FindType.FindByThumbprint, "cd 54 88 85 0d 63 db ac 92 59 05 af ce b8 b1 de c3 67 9e 3f", false);
        store.Close();

        // Create an EndpointIdentity from the STS certificate
        EndpointIdentity identity = EndpointIdentity.CreateX509CertificateIdentity(certs[0]);

        // Set the IssuerAddress using the address of the STS and the previously created EndpointIdentity
        b.Security.Message.IssuerAddress = new EndpointAddress(new Uri("http://localhost:8000/sts/x509"), identity);

        // Set the IssuerBinding to a WSHttpBinding loaded from config
        b.Security.Message.IssuerBinding = new WSHttpBinding("Issuer");

        // Set the IssuerMetadataAddress using the metadata address of the STS and the previously created EndpointIdentity
        b.Security.Message.IssuerMetadataAddress = new EndpointAddress(new Uri("http://localhost:8001/sts/mex"), identity);

        // Create a ClaimTypeRequirement
        ClaimTypeRequirement ctr = new ClaimTypeRequirement("http://example.org/claim/c1", false);

        // Add the ClaimTypeRequirement to ClaimTypeRequirements
        b.Security.Message.ClaimTypeRequirements.Add(ctr);

        // Return the created binding
        return b;
    }

}

// Service class which implements the service contract. 
public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        double result = n1 + n2; return result;
    }
    public double Subtract(double n1, double n2)
    {
        double result = n1 - n2; return result;
    }
    public double Multiply(double n1, double n2)
    {
        double result = n1 * n2; return result;
    }
    public double Divide(double n1, double n2)
    {
        double result = n1 / n2; return result;
    }


    // Host the service within this EXE console application. 
    public static void Main()
    {
        // Create a WSHttpBinding and set its property values. 
        WSHttpBinding binding = new WSHttpBinding();
        binding.Name = "binding1";
        binding.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;
        binding.Security.Mode = SecurityMode.Message;
        binding.ReliableSession.Enabled = false;
        binding.TransactionFlow = false;
        //Specify a base address for the service endpoint. 
        Uri baseAddress = new Uri(@"http://localhost:8000/servicemodelsamples/service");
        // Create a ServiceHost for the CalculatorService type 
        // and provide it with a base address. 
        ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);
        serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, baseAddress);
        // Open the ServiceHostBase to create listeners 
        // and start listening for messages. 
        serviceHost.Open();
        // The service can now be accessed. 
        Console.WriteLine("The service is ready.");
        Console.WriteLine("Press <ENTER> to terminate service.");
        Console.WriteLine(); Console.ReadLine();
        // Close the ServiceHost to shutdown the service. 
        serviceHost.Close();
    }
}

.NET Framework
Disponible depuis 3.0

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
Afficher: