Partager via


BasicHttpBinding Classe

Définition

Représente une liaison qu’un service Windows Communication Foundation (WCF) 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 conformes au profil WS-I Basic Profile 1.1.

public ref class BasicHttpBinding : System::ServiceModel::HttpBindingBase
public ref class BasicHttpBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences
public class BasicHttpBinding : System.ServiceModel.HttpBindingBase
public class BasicHttpBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
type BasicHttpBinding = class
    inherit HttpBindingBase
type BasicHttpBinding = class
    inherit Binding
    interface IBindingRuntimePreferences
type BasicHttpBinding = class
    inherit HttpBindingBase
    interface IBindingRuntimePreferences
Public Class BasicHttpBinding
Inherits HttpBindingBase
Public Class BasicHttpBinding
Inherits Binding
Implements IBindingRuntimePreferences
Héritage
BasicHttpBinding
Héritage
BasicHttpBinding
Dérivé
Implémente

Exemples

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

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();

    }
}
   <ServiceContract(Namespace:="http://UE.ServiceModel.Samples")> _
   Public Interface ICalculator

       <OperationContract()> _
       Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double
       <OperationContract()> _
       Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double
       <OperationContract()> _
       Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double
       <OperationContract()> _
       Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double
   End Interface

   ' Service class which implements the service contract.
   ' Added code to write output to the console window
   Public Class CalculatorService
       Implements ICalculator

       Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double _
Implements ICalculator.Add

           Dim result As Double = n1 + n2
           Console.WriteLine("Received Add({0},{1})", n1, n2)
           Console.WriteLine("Return: {0}", result)
           Return result
       End Function

       Public Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double _
Implements ICalculator.Subtract

           Dim result As Double = n1 - n2
           Console.WriteLine("Received Subtract({0},{1})", n1, n2)
           Console.WriteLine("Return: {0}", result)
           Return result
       End Function

       Public Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double _
Implements ICalculator.Multiply

           Dim result As Double = n1 * n2
           Console.WriteLine("Received Multiply({0},{1})", n1, n2)
           Console.WriteLine("Return: {0}", result)
           Return result
       End Function

       Public Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double _
Implements ICalculator.Divide

           Dim result As Double = n1 / n2
           Console.WriteLine("Received Divide({0},{1})", n1, n2)
           Console.WriteLine("Return: {0}", result)
           Return result
       End Function

       Public Shared Sub Main()
           Dim binding As BasicHttpBinding = New BasicHttpBinding()
           binding.Name = "binding1"
           binding.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard
           binding.Security.Mode = BasicHttpSecurityMode.None

           Dim baseAddress As Uri = New Uri("http://localhost:8000/servicemodelsamples/service")
           Dim address As Uri = New Uri("http://localhost:8000/servicemodelsamples/service/calc")

           ' Create a ServiceHost for the CalculatorService type and provide the base address.
           Using serviceHost As ServiceHost = New ServiceHost(GetType(CalculatorService), baseAddress)

               serviceHost.AddServiceEndpoint(GetType(ICalculator), binding, address)

               ' Open the ServiceHost 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()
           End Using
       End Sub
   End Class

Remarques

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 même, un client peut utiliser le BasicHttpBinding service pour communiquer avec des services exposant des points de terminaison conformes aux services WS-I BP 1.1, tels que les services Web ASMX ou Windows les services WCF (Communication Foundation) 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, il utilise un encodage de message "Texte" et un encodage texte UTF-8.

Constructeurs

BasicHttpBinding()

Initialise une nouvelle instance de la classe BasicHttpBinding.

BasicHttpBinding(BasicHttpSecurityMode)

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

BasicHttpBinding(String)

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

Propriétés

AllowCookies

Obtient ou définit une valeur qui indique si le client accepte les cookies et les propage sur les requêtes ultérieures.

AllowCookies

Obtient ou définit une valeur qui indique si le client accepte les cookies et les propage sur les requêtes ultérieures.

(Hérité de HttpBindingBase)
BypassProxyOnLocal

Obtient ou définit une valeur qui indique s'il convient d'ignorer le serveur proxy pour les adresses locales.

BypassProxyOnLocal

Obtient ou définit une valeur qui indique s'il convient d'ignorer le serveur proxy pour les adresses locales.

(Hérité de HttpBindingBase)
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)
EnableHttpCookieContainer
Obsolète.

Obtient ou définit une valeur indiquant si le conteneur de cookies HTTP est activé.

EnvelopeVersion

Obtient la version de SOAP utilisée pour les messages traités par cette liaison.

EnvelopeVersion

Obtient la version de SOAP utilisée pour les messages traités par cette liaison.

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

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 HttpBindingBase)
MaxBufferPoolSize

Obtient ou définit la quantité maximale de mémoire (en octets) allouée au gestionnaire des tampons de messages qui reçoivent des messages du canal.

MaxBufferPoolSize

Obtient ou définit la quantité maximale de mémoire (en octets) allouée au gestionnaire des tampons de messages qui reçoit des messages du canal.

(Hérité de HttpBindingBase)
MaxBufferSize

Obtient ou définit la taille maximale (en octets) d'une mémoire tampon qui reçoit les messages du canal.

MaxBufferSize

Obtient ou définit la taille maximale (en octets) d'une mémoire tampon qui reçoit les messages du canal.

(Hérité de HttpBindingBase)
MaxReceivedMessageSize

Obtient ou définit la taille maximale (en octets) d'un message qui peut être reçu sur un canal configuré avec cette liaison.

MaxReceivedMessageSize

Obtient ou définit la taille maximale (en octets) d'un message qui peut être reçu sur un canal configuré avec cette liaison.

(Hérité de HttpBindingBase)
MessageEncoding

Obtient ou définit si MTOM ou Text est utilisé pour encoder les messages SOAP.

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.

ProxyAddress

Obtient ou définit l'adresse URI du proxy HTTP.

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

ReaderQuotas

Obtient ou définit les contraintes sur la complexité des messages SOAP qui peuvent être traités par les points de terminaison configurés avec cette liaison.

(Hérité de HttpBindingBase)
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)
Scheme

Obtient le schéma de transport URI pour les canaux et les écouteurs configurés avec cette liaison.

Scheme

Obtient le schéma de transport URI pour les canaux et les écouteurs configurés avec cette liaison.

(Hérité de HttpBindingBase)
Security

Obtient le type de sécurité utilisé 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.

TextEncoding

Obtient ou définit l'encodage de caractères utilisé pour le texte du message.

(Hérité de HttpBindingBase)
TransferMode

Obtient ou définit une valeur qui indique si les messages sont mis en mémoire tampon ou transmis en continu.

TransferMode

Obtient ou définit une valeur qui indique si les messages sont mis en mémoire tampon ou transmis en continu.

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

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

Méthodes

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.

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, 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, 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, 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, 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)
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 exigences 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()

Crée et renvoie une collection ordonnée d'éléments de liaison contenus dans la liaison actuelle.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetProperty<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)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ShouldSerializeEnableHttpCookieContainer()

Indique si le conteneur de cookies HTTP doit permettre la sérialisation.

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 indiquant si les valeurs de contrainte placées sur la complexité de la structure des messages SOAP doivent être sérialisées.

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.

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

ShouldSerializeTextEncoding()

Retourne une valeur indiquant si les paramètres pour le codage de texte doivent être sérialisés.

ShouldSerializeTextEncoding()

Retourne une valeur indiquant si les paramètres pour le codage de texte doivent être sérialisés.

(Hérité de HttpBindingBase)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

IBindingRuntimePreferences.ReceiveSynchronously

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

IBindingRuntimePreferences.ReceiveSynchronously

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

(Hérité de HttpBindingBase)

S’applique à