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

BasicHttpBinding, classe

Représente une liaison qu'un service peut utiliser pour configurer et exposer des points de terminaison capables de communiquer avec des clients et services Web basés sur ASMX, ainsi qu'avec d'autres services respectant le profil WS-I Basic Profile 1.1.

Espace de noms :  System.ServiceModel
Assembly :  System.ServiceModel (dans System.ServiceModel.dll)
public class BasicHttpBinding : Binding, 
	IBindingRuntimePreferences

Le type BasicHttpBinding expose les membres suivants.

  Nom Description
Méthode publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif BasicHttpBinding() Initialise une nouvelle instance de la classe BasicHttpBinding.
Méthode publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif BasicHttpBinding(BasicHttpSecurityMode) Initialise une nouvelle instance de la classe BasicHttpBinding avec le type spécifié de sécurité utilisé par la liaison.
Méthode publique BasicHttpBinding(String) Initialise une nouvelle instance de la classe BasicHttpBinding avec une liaison spécifiée par son nom de configuration.
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.
Propriété publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 ms405774.PortableClassLibrary(fr-fr,VS.100).gif EnvelopeVersion Obtient la version de SOAP utilisée pour les messages traités par cette liaison.
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.
Propriété publique MaxBufferPoolSize Obtient ou définit la quantité maximale de mémoire allouée au gestionnaire des tampons de messages qui reçoit des messages du canal.
Propriété publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif MaxBufferSize Obtient ou définit la taille maximale pour une mémoire tampon qui reçoit des messages du canal.
Propriété publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif MaxReceivedMessageSize Obtient ou définit la taille maximale d'un message pouvant être reçu sur un canal configuré avec cette liaison.
Propriété publique MessageEncoding Obtient ou définit si MTOM ou Text est utilisé pour encoder les messages SOAP.
Propriété publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 ms405774.PortableClassLibrary(fr-fr,VS.100).gif Name Obtient ou définit le nom de la liaison. (Hérité de Binding.)
Propriété publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif Namespace Obtient ou définit l'espace de noms XML de la liaison. (Hérité de Binding.)
Propriété publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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.
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.
Propriété publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 ms405774.PortableClassLibrary(fr-fr,VS.100).gif Scheme Obtient le schéma de transport URI pour les canaux et les écouteurs configurés avec cette liaison. (Substitue Binding.Scheme.)
Propriété publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif Security Obtient le type de sécurité utilisé avec cette liaison.
Propriété publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 ms405774.PortableClassLibrary(fr-fr,VS.100).gif TextEncoding Obtient ou définit le codage de caractères utilisé pour le texte du message.
Propriété publique TransferMode Obtient ou définit une valeur qui indique si les messages sont mis en mémoire tampon ou transmis en continu.
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.
Début
  Nom Description
Méthode publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 ms405774.PortableClassLibrary(fr-fr,VS.100).gif CreateBindingElements Retourne une collection ordonnée d'éléments de liaison contenus dans la liaison actuelle. (Substitue Binding.CreateBindingElements().)
Méthode publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 ms405774.PortableClassLibrary(fr-fr,VS.100).gif GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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 indiquant si les valeurs de contrainte placées sur la complexité de la structure des messages SOAP doivent être sérialisées.
Méthode publique ShouldSerializeSecurity Retourne une valeur indiquant si les paramètres de sécurité doivent être sérialisés selon que la sérialisation s'est déjà produit, par exemple au niveau du message ou du transport.
Méthode publique ShouldSerializeTextEncoding Retourne une valeur indiquant si les paramètres pour le codage de texte doivent être sérialisés.
Méthode publique ms405774.PortableClassLibrary(fr-fr,VS.100).gif 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.
Début

Le BasicHttpBinding utilise HTTP en guise de transport pour envoyer des messages SOAP 1.1. Un service peut utiliser cette liaison pour exposer des points de terminaison qui se conforment à WS-I BP 1.1, tels que ceux auxquels les clients ASMX accèdent. De la même façon, un client peut utiliser le BasicHttpBinding pour communiquer avec des services qui exposent des points de terminaison conformes au profil WS-I BP 1.1, tel que des services Web ASMX ou des services configurés avec le BasicHttpBinding.

La sécurité est désactivée par défaut, mais peut être ajoutée en affectant à BasicHttpSecurityMode une valeur autre que None dans le constructeur BasicHttpBinding(BasicHttpSecurityMode). Par défaut, elle utilise un encodage de message "Texte" et un encodage texte UTF-8.

L'exemple suivant montre comment configurer le BasicHttpBinding dans un fichier de configuration de l'application.


<system.serviceModel>
  <services>
    <service
        name="Microsoft.ServiceModel.Samples.CalculatorService"
        behaviorConfiguration="CalculatorServiceBehavior">
      <!-- use base address provided by host -->
      <!-- specify BasicHttp binding and a binding configuration to use -->
      <endpoint address=""
                binding="basicHttpBinding"
                bindingConfiguration="Binding1"
                contract="Microsoft.ServiceModel.Samples.ICalculator" />
    </service>
  </services>

  <bindings>
    <!-- 
          Following is the expanded configuration section for a BasicHttpBinding.
          Each property is configured with the default value.
          See the TransportSecurity, and MessageSecurity samples in the
          Basic directory to learn how to configure these features.
          -->
    <basicHttpBinding>
      <binding name="Binding1"
               hostNameComparisonMode="StrongWildcard"
               receiveTimeout="00:10:00"
               sendTimeout="00:10:00"
               openTimeout="00:10:00"
               closeTimeout="00:10:00"
               maxReceivedMessageSize="65536"
               maxBufferSize="65536"
               maxBufferPoolSize="524288"
               transferMode="Buffered"
               messageEncoding="Text"
               textEncoding="utf-8"
               bypassProxyOnLocal="false"
               useDefaultWebProxy="true" >
        <security mode="None" />
      </binding>
    </basicHttpBinding>
  </bindings>

  <!--For debugging purposes set the returnUnknownExceptionsAsFaults attribute to true-->
  <behaviors>
    <serviceBehaviors>
      <behavior name="CalculatorServiceBehavior">
        <serviceDebug includeExceptionDetailInFaults="true" />
      </behavior>
    </serviceBehaviors>
  </behaviors>

</system.serviceModel>


L'exemple suivant montre comment configurer par programme BasicHttpBinding.


    [ServiceContract(Namespace = "http://UE.ServiceModel.Samples")]
    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 class CalculatorService : ICalculator
    {
        public double Add(double n1, double n2)
        {
            double result = n1 + n2;
            Console.WriteLine("Received Add({0},{1})", n1, n2);
            Console.WriteLine("Return: {0}", result);
            return result;
        }

        public double Subtract(double n1, double n2)
        {
            double result = n1 - n2;
            Console.WriteLine("Received Subtract({0},{1})", n1, n2);
            Console.WriteLine("Return: {0}", result);
            return result;
        }

        public double Multiply(double n1, double n2)
        {
            double result = n1 * n2;
            Console.WriteLine("Received Multiply({0},{1})", n1, n2);
            Console.WriteLine("Return: {0}", result);
            return result;
        }

        public double Divide(double n1, double n2)
        {
            double result = n1 / n2;
            Console.WriteLine("Received Divide({0},{1})", n1, n2);
            Console.WriteLine("Return: {0}", result);
            return result;
        }

        public static void Main()
        {
            BasicHttpBinding binding = new BasicHttpBinding();
            binding.Name = "binding1";
            binding.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;
            binding.Security.Mode = BasicHttpSecurityMode.None;

            Uri baseAddress = new Uri("http://localhost:8000/servicemodelsamples/service");
            Uri address = new Uri("http://localhost:8000/servicemodelsamples/service/calc");

            // Create a ServiceHost for the CalculatorService type and provide the base address.
            ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);

            serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, address);

            // 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 ServiceHostBase 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

Pris en charge dans :

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