Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

WSHttpBinding, classe

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

Le type WSHttpBinding expose les membres suivants.

  Nom Description
Méthode publique WSHttpBinding() Initialise une nouvelle instance de la classe WSHttpBinding.
Méthode publique WSHttpBinding(SecurityMode) Initialise une nouvelle instance de la classe WSHttpBinding avec un type spécifié de sécurité utilisé par la liaison.
Méthode publique WSHttpBinding(String) Initialise une nouvelle instance de la classe WSHttpBinding avec une liaison spécifiée par son nom de configuration.
Méthode publique WSHttpBinding(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.
Début
  Nom Description
Propriété publique AllowCookies Obtient ou définit une valeur qui indique si le client accepte les cookies et les propage aux demandes suivantes.
Propriété publique BypassProxyOnLocal Obtient ou définit une valeur qui indique si le serveur proxy doit être contourné pour les adresses locales. (Hérité de WSHttpBindingBase.)
Propriété publique 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.)
Propriété publique EnvelopeVersion Obtient la version de SOAP utilisée pour les messages traités par cette liaison. (Hérité de WSHttpBindingBase.)
Propriété publique 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. (Hérité de WSHttpBindingBase.)
Propriété publique MaxBufferPoolSize Obtient ou définit la quantité de mémoire maximale allouée pour le gestionnaire de tampons qui gère les mémoires tampons requises par les points de terminaison qui utilisent cette liaison. (Hérité de WSHttpBindingBase.)
Propriété publique MaxReceivedMessageSize Obtient ou définit la taille maximale d'un message qui peut être traité par la liaison. (Hérité de WSHttpBindingBase.)
Propriété publique MessageEncoding Obtient ou définit si MTOM ou Text/XML est utilisé pour encoder les messages SOAP. (Hérité de WSHttpBindingBase.)
Propriété publique MessageVersion Obtient la version de message utilisée par les clients et les services configurés avec la liaison. (Hérité de Binding.)
Propriété publique Name Obtient ou définit le nom de la liaison. (Hérité de Binding.)
Propriété publique Namespace Obtient ou définit l'espace de noms XML de la liaison. (Hérité de Binding.)
Propriété publique 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.)
Propriété publique ProxyAddress Obtient ou définit l'adresse URI du proxy HTTP. (Hérité de WSHttpBindingBase.)
Propriété publique 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. (Hérité de WSHttpBindingBase.)
Propriété publique 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.)
Propriété publique ReliableSession 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.)
Propriété publique Scheme Obtient le schéma de transport URI pour les canaux et les écouteurs configurés avec cette liaison. (Hérité de WSHttpBindingBase.)
Propriété publique Security Obtient les paramètres de sécurité utilisés avec cette liaison.
Propriété publique 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.)
Propriété publique TextEncoding Obtient ou définit l'encodage de caractères utilisé pour le texte du message. (Hérité de WSHttpBindingBase.)
Propriété publique TransactionFlow Obtient ou définit une valeur indiquant si la liaison doit prendre en charge le flux WS-Transactions. (Hérité de WSHttpBindingBase.)
Propriété publique UseDefaultWebProxy 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.)
Début
  Nom Description
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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 spécifications définies par un tableau d'objets. (Hérité de Binding.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique CreateBindingElements Retourne une collection ordonnée d'éléments de liaison contenus dans la liaison actuelle. (Substitue WSHttpBindingBase.CreateBindingElements().)
Méthode protégée CreateMessageSecurity Retourne l'élément de liaison de sécurité de la liaison actuelle. (Substitue WSHttpBindingBase.CreateMessageSecurity().)
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetProperty<T> Retourne un objet typé demandé (s'il existe) à partir de la couche appropriée dans la pile de liaison. (Hérité de Binding.)
Méthode protégée GetTransport Retourne l'élément de liaison de transport de la liaison actuelle. (Substitue WSHttpBindingBase.GetTransport().)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique ShouldSerializeName Retourne une valeur indiquant si le nom de la liaison doit être sérialisé. (Hérité de Binding.)
Méthode publique ShouldSerializeNamespace Retourne une valeur indiquant si l'espace de noms de la liaison doit être sérialisé. (Hérité de Binding.)
Méthode publique ShouldSerializeReaderQuotas Retourne une valeur qui indique si la propriété ReaderQuotas utilise une autre valeur que sa valeur par défaut et si elle doit être sérialisée. (Hérité de WSHttpBindingBase.)
Méthode publique ShouldSerializeReliableSession Renvoie 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.)
Méthode publique ShouldSerializeSecurity Renvoie 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.
Méthode publique ShouldSerializeTextEncoding Renvoie 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.)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début
  Nom Description
Implémentation d'interface explicite Propriété privée IBindingRuntimePreferences.ReceiveSynchronously Obtient une valeur qui indique si les demandes entrantes sont gérées de façon synchrone ou asynchrone. (Hérité de WSHttpBindingBase.)
Début

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

Pris en charge dans : 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ