BasicHttpBinding Classe

Définition

Espace de noms:: System.ServiceModel

Assemblys:: System.ServiceModel.dll, System.ServiceModel.Http.dll

Assembly:: System.ServiceModel.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 les services web basés sur ASMX et les clients et d’autres services conformes au profil de base WS-I 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

Public Class BasicHttpBinding
Inherits HttpBindingBase

Public Class BasicHttpBinding
Inherits Binding
Implements IBindingRuntimePreferences

Héritage: Object

Binding

HttpBindingBase
BasicHttpBinding

Héritage: Object

Binding
BasicHttpBinding

Dérivé: System.ServiceModel.BasicHttpContextBinding

Implémente: IBindingRuntimePreferences

Exemples

L’exemple suivant montre comment configurer le BasicHttpBinding fichier de configuration d’une application.

L’exemple suivant montre comment configurer BasicHttpBindingpar programme .

[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

Utilise BasicHttpBinding HTTP comme transport pour l’envoi de messages SOAP 1.1. Un service peut utiliser cette liaison pour exposer des points de terminaison conformes à WS-I BP 1.1, tels que ceux auxquels les clients ASMX accèdent. De même, un client peut utiliser le BasicHttpBinding pour communiquer avec les services exposant des points de terminaison conformes à WS-I BP 1.1, tels que les services Web ASMX ou les services Windows Communication Foundation (WCF) configurés avec le BasicHttpBinding.

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

Constructeurs

Nom	Description
BasicHttpBinding()	Initialise une nouvelle instance de la classe BasicHttpBinding.
BasicHttpBinding(BasicHttpSecurityMode)	Initialise une nouvelle instance de la BasicHttpBinding classe avec un type de sécurité spécifié utilisé par la liaison.
BasicHttpBinding(String)	Initialise une nouvelle instance de la BasicHttpBinding classe avec une liaison spécifiée par son nom de configuration.

Propriétés

Nom	Description
AllowCookies	Obtient ou définit une valeur qui indique si le client accepte les cookies et les propage sur les demandes futures.
AllowCookies	Obtient ou définit une valeur qui indique si le client accepte les cookies et les propage sur les demandes futures. (Hérité de HttpBindingBase)
BypassProxyOnLocal	Obtient ou définit une valeur qui indique s’il faut contourner le serveur proxy pour les adresses locales.
BypassProxyOnLocal	Obtient ou définit une valeur qui indique s’il faut contourner le serveur proxy pour les adresses locales. (Hérité de HttpBindingBase)
CloseTimeout	Obtient ou définit l’intervalle de temps fourni pour une connexion à fermer avant que le transport déclenche une exception. (Hérité de Binding)
EnableHttpCookieContainer	Obsolète. Obtient ou définit une valeur qui indique 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 de 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 de l’URI. (Hérité de HttpBindingBase)
MaxBufferPoolSize	Obtient ou définit la quantité maximale de mémoire, en octets, allouée pour être utilisée par le gestionnaire des mémoires 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 pour être utilisée par le gestionnaire des mémoires tampons de messages qui reçoivent des messages du canal. (Hérité de HttpBindingBase)
MaxBufferSize	Obtient ou définit la taille maximale, en octets, pour une mémoire tampon qui reçoit des messages du canal.
MaxBufferSize	Obtient ou définit la taille maximale, en octets, pour une mémoire tampon qui reçoit des messages du canal. (Hérité de HttpBindingBase)
MaxReceivedMessageSize	Obtient ou définit la taille maximale, en octets, pour un message qui peut être reçu sur un canal configuré avec cette liaison.
MaxReceivedMessageSize	Obtient ou définit la taille maximale, en octets, pour 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 des messages SOAP.
MessageVersion	Obtient la version du 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 fourni pour qu’une connexion s’ouvre avant que le transport déclenche 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 qui peuvent ê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 l’intervalle de temps pendant lequel une connexion peut rester inactive, pendant laquelle aucun message d’application n’est reçu, avant d’être supprimé. (Hérité de Binding)
Scheme	Obtient le schéma de transport d’URI pour les canaux et les écouteurs configurés avec cette liaison.
Scheme	Obtient le schéma de transport d’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 fourni pour qu’une opération d’écriture se termine avant que le transport déclenche 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 envoyés en mémoire tampon ou diffusées en continu.
TransferMode	Obtient ou définit une valeur qui indique si les messages sont envoyés en mémoire tampon ou diffusées en continu. (Hérité de HttpBindingBase)
UseDefaultWebProxy	Obtient ou définit une valeur qui indique si le proxy HTTP configuré automatiquement du système doit être utilisé, le cas échéant.
UseDefaultWebProxy	Obtient ou définit une valeur qui indique si le proxy HTTP configuré automatiquement du système doit être utilisé, le cas échéant. (Hérité de HttpBindingBase)

Méthodes

Nom	Description
BuildChannelFactory<TChannel>(BindingParameterCollection)	Génère la pile de fabrique de canaux sur le client qui crée un type de canal spécifié et qui satisfait aux fonctionnalités spécifiées par une collection de paramètres de liaison.
BuildChannelFactory<TChannel>(BindingParameterCollection)	Génère la pile de fabrique de canaux sur le client qui crée un type de canal spécifié et qui satisfait 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 fabrique de canaux sur le client qui crée un type de canal spécifié et qui satisfait 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 spécifié et qui satisfait 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 spécifié et qui satisfait 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 spécifié et qui satisfait 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 spécifié et qui satisfait 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 spécifié et qui satisfait 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 spécifié et qui satisfait 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 spécifié et qui satisfait 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 spécifié et qui satisfait 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 une pile de fabriques de canaux sur le client qui satisfait à la collection de paramètres de liaison spécifié. (Hérité de Binding)
CanBuildChannelFactory<TChannel>(Object[])	Retourne une valeur qui indique si la liaison actuelle peut générer une pile de fabriques de canaux sur le client qui répond aux exigences spécifiées 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 une pile d’écouteurs de canal sur le service qui satisfait à la collection de paramètres de liaison spécifié. (Hérité de Binding)
CanBuildChannelListener<TChannel>(Object[])	Retourne une valeur qui indique si la liaison actuelle peut générer une pile d’écouteurs de canal sur le service qui répond aux critères spécifiés dans un tableau d’objets. (Hérité de Binding)
CreateBindingElements()	Crée et retourne 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()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetProperty<T>(BindingParameterCollection)	Retourne un objet typé demandé, le cas échéant, à partir de la couche appropriée dans la pile de liaisons. (Hérité de Binding)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ShouldSerializeEnableHttpCookieContainer()	Indique si le conteneur de cookies http doit activer la sérialisation.
ShouldSerializeName()	Retourne si le nom de la liaison doit être sérialisé. (Hérité de Binding)
ShouldSerializeNamespace()	Retourne si l’espace de noms de la liaison doit être sérialisé. (Hérité de Binding)
ShouldSerializeReaderQuotas()	Retourne si les valeurs de contrainte placées sur la complexité de la structure de messages SOAP doivent être sérialisées.
ShouldSerializeReaderQuotas()	Retourne si les valeurs de contrainte placées sur la complexité de la structure de messages SOAP doivent être sérialisées. (Hérité de HttpBindingBase)
ShouldSerializeSecurity()	Retourne si les paramètres de sécurité doivent être sérialisés selon que la sérialisation se produit déjà, par exemple au niveau du message ou du transport.
ShouldSerializeTextEncoding()	Retourne si les paramètres d’encodage de texte doivent être sérialisés.
ShouldSerializeTextEncoding()	Retourne si les paramètres d’encodage 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

Nom	Description
IBindingRuntimePreferences.ReceiveSynchronously	Obtient une valeur qui indique si les requêtes entrantes sont gérées de manière synchrone ou asynchrone.
IBindingRuntimePreferences.ReceiveSynchronously	Obtient une valeur qui indique si les requêtes entrantes sont gérées de manière synchrone ou asynchrone. (Hérité de HttpBindingBase)

S’applique à

Commentaires

Cette page a-t-elle été utile ?