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
|
WSHttpBinding, classe
Représente une liaison interopérable qui prend en charge les transactions distribuées et les sessions fiables et sécurisées.
Assembly : System.ServiceModel (dans System.ServiceModel.dll)
Le type WSHttpBinding expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
WSHttpBinding() | Initialise une nouvelle instance de la classe WSHttpBinding. |
|
WSHttpBinding(SecurityMode) | Initialise une nouvelle instance de la classe WSHttpBinding avec un type spécifié de sécurité utilisé par la liaison. |
|
WSHttpBinding(String) | Initialise une nouvelle instance de la classe WSHttpBinding avec une liaison spécifiée par son nom de configuration. |
|
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. |
| Nom | Description | |
|---|---|---|
|
AllowCookies | Obtient ou définit une valeur qui indique si le client accepte les cookies et les propage aux demandes suivantes. |
|
BypassProxyOnLocal | Obtient ou définit une valeur qui indique si le serveur proxy doit être contourné pour les adresses locales. (Hérité de WSHttpBindingBase.) |
|
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. (Hérité de WSHttpBindingBase.) |
|
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.) |
|
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.) |
|
MaxReceivedMessageSize | Obtient ou définit la taille maximale d'un message qui peut être traité par la liaison. (Hérité de WSHttpBindingBase.) |
|
MessageEncoding | Obtient ou définit si MTOM ou Text/XML est utilisé pour encoder les messages SOAP. (Hérité de WSHttpBindingBase.) |
|
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.) |
|
ProxyAddress | Obtient ou définit l'adresse URI du proxy HTTP. (Hérité de WSHttpBindingBase.) |
|
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.) |
|
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 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.) |
|
Scheme | Obtient le schéma de transport URI pour les canaux et les écouteurs configurés avec cette liaison. (Hérité de WSHttpBindingBase.) |
|
Security | Obtient les paramètres de sécurité utilisé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.) |
|
TextEncoding | Obtient ou définit l'encodage de caractères utilisé pour le texte du message. (Hérité de WSHttpBindingBase.) |
|
TransactionFlow | Obtient ou définit une valeur indiquant si la liaison doit prendre en charge le flux WS-Transactions. (Hérité de WSHttpBindingBase.) |
|
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.) |
| Nom | Description | |
|---|---|---|
|
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, 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, 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.) |
|
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, 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, 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.) |
|
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 spécifications 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 | Retourne une collection ordonnée d'éléments de liaison contenus dans la liaison actuelle. (Substitue WSHttpBindingBase.CreateBindingElements().) |
|
CreateMessageSecurity | Retourne l'élément de liaison de sécurité de la liaison actuelle. (Substitue WSHttpBindingBase.CreateMessageSecurity().) |
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
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.) |
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
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.) |
|
GetTransport | Retourne l'élément de liaison de transport de la liaison actuelle. (Substitue WSHttpBindingBase.GetTransport().) |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
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 si elle doit être sérialisée. (Hérité de WSHttpBindingBase.) |
|
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.) |
|
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. |
|
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.) |
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
| Nom | Description | |
|---|---|---|
|
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.) |
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(); } }
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.