BasicHttpBinding Clase

Definición

Representa un enlace que un servicio Windows Communication Foundation (WCF) puede usar para configurar y exponer puntos de conexión que puedan comunicarse con servicios web basados en ASMX y clientes y otros servicios que cumplan con 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
Public Class BasicHttpBinding
Inherits HttpBindingBase
Public Class BasicHttpBinding
Inherits Binding
Implements IBindingRuntimePreferences
Herencia
BasicHttpBinding
Herencia
BasicHttpBinding
Derivado
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra cómo configurar BasicHttpBinding en un archivo de configuración de la aplicación.

En el ejemplo siguiente se muestra cómo configurar mediante programación un 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

Comentarios

BasicHttpBinding utiliza HTTP como transporte para enviar los mensajes SOAP 1.1. Servicio puede utilizar este enlace para exponer puntos de conexión que cumplen con WS-I BP 1.1, como aquellos a los que tienen acceso clientes ASMX. Del mismo modo, un cliente puede usar BasicHttpBinding para comunicarse con servicios que exponen puntos de conexión que cumplen con WS-I BP 1.1, como servicios web ASMX o servicios de Windows Communication Foundation (WCF) configurados con BasicHttpBinding.

La seguridad está desactivada de forma predeterminada, pero se puede agregar estableciendo BasicHttpSecurityMode con un valor distinto de None en el constructor BasicHttpBinding(BasicHttpSecurityMode). De forma predeterminada, usa una codificación de mensajes "Text" y codificación de texto UTF-8.

Constructores

BasicHttpBinding()

Inicializa una nueva instancia de la clase BasicHttpBinding.

BasicHttpBinding(BasicHttpSecurityMode)

Inicializa una nueva instancia de la clase BasicHttpBinding con un tipo de seguridad especificado utilizado por el enlace.

BasicHttpBinding(String)

Inicializa una nueva instancia de la clase BasicHttpBinding con un enlace especificado por su nombre de configuración.

Propiedades

AllowCookies

Obtiene o establece un valor que indica si el cliente acepta las cookies y las propaga en solicitudes futuras.

AllowCookies

Obtiene o establece un valor que indica si el cliente acepta las cookies y las propaga en solicitudes futuras.

(Heredado de HttpBindingBase)
BypassProxyOnLocal

Obtiene o establece un valor que indica si debe omitirse el servidor proxy para las direcciones locales.

BypassProxyOnLocal

Obtiene o establece un valor que indica si debe omitirse el servidor proxy para las direcciones locales.

(Heredado de HttpBindingBase)
CloseTimeout

Obtiene o establece el intervalo de tiempo proporcionado para que una conexión se cierre antes de que el transporte genere una excepción.

(Heredado de Binding)
EnableHttpCookieContainer
Obsoletos.

Obtiene o establece un valor que indica si el contenedor de cookie HTTP se ha habilitado.

EnvelopeVersion

Obtiene la versión de SOAP que se utiliza para los mensajes procesados por este enlace.

EnvelopeVersion

Obtiene la versión de SOAP que se utiliza para los mensajes procesados por este enlace.

(Heredado de HttpBindingBase)
HostNameComparisonMode

Obtiene o establece un valor que indica si el nombre del host se usa para alcanzar el servicio al coincidir con el URI.

HostNameComparisonMode

Obtiene o establece un valor que indica si el nombre del host se usa para alcanzar el servicio al coincidir con el URI.

(Heredado de HttpBindingBase)
MaxBufferPoolSize

Obtiene o establece la cantidad de memoria máxima, en bytes, que se asigna para que la use el administrador de los búferes de mensajes que reciben los mensajes del canal.

MaxBufferPoolSize

Obtiene o establece la cantidad de memoria máxima, en bytes, que se asigna para que la use el administrador de los búferes de mensajes que reciben los mensajes del canal.

(Heredado de HttpBindingBase)
MaxBufferSize

Obtiene o establece el tamaño máximo, en bytes, para un búfer que recibe mensajes del canal.

MaxBufferSize

Obtiene o establece el tamaño máximo, en bytes, para un búfer que recibe mensajes del canal.

(Heredado de HttpBindingBase)
MaxReceivedMessageSize

Obtiene o establece el tamaño máximo, en bytes, de un mensaje que se puede recibir en un canal configurado con este enlace.

MaxReceivedMessageSize

Obtiene o establece el tamaño máximo, en bytes, de un mensaje que se puede recibir en un canal configurado con este enlace.

(Heredado de HttpBindingBase)
MessageEncoding

Obtiene o establece si se usa MTOM o Texto para codificar los mensajes SOAP.

MessageVersion

Obtiene la versión de mensaje utilizada por los clientes y servicios configurados con el enlace.

(Heredado de Binding)
Name

Obtiene o establece el nombre del enlace.

(Heredado de Binding)
Namespace

Obtiene o establece el espacio de nombres XML del enlace.

(Heredado de Binding)
OpenTimeout

Obtiene o establece el intervalo de tiempo proporcionado para que una conexión se abra antes de que el transporte genere una excepción.

(Heredado de Binding)
ProxyAddress

Obtiene o establece la dirección URI del proxy HTTP.

ProxyAddress

Obtiene o establece la dirección URI del proxy HTTP.

(Heredado de HttpBindingBase)
ReaderQuotas

Obtiene o establece restricciones en la complejidad de mensajes SOAP que pueden ser procesados por puntos de conexión configurados con este enlace.

ReaderQuotas

Obtiene o establece restricciones en la complejidad de mensajes SOAP que pueden ser procesados por extremos configurados con este enlace.

(Heredado de HttpBindingBase)
ReceiveTimeout

Obtiene o establece el intervalo de tiempo que una conexión puede permanecer inactiva, durante el cual no se recibe ningún mensaje de la aplicación, antes de interrumpir la conexión.

(Heredado de Binding)
Scheme

Obtiene el esquema de transporte de URI para los canales y agentes de escucha que se configuran con este enlace.

Scheme

Obtiene el esquema de transporte de URI para los canales y agentes de escucha que se configuran con este enlace.

(Heredado de HttpBindingBase)
Security

Obtiene el tipo de seguridad utilizado con este enlace.

SendTimeout

Obtiene o establece el intervalo de tiempo proporcionado para que una operación de escritura se complete antes de que el transporte genere una excepción.

(Heredado de Binding)
TextEncoding

Obtiene o establece la codificación de caracteres que se usa para el texto del mensaje.

TextEncoding

Obtiene o establece la codificación de caracteres que se usa para el texto del mensaje.

(Heredado de HttpBindingBase)
TransferMode

Obtiene o establece un valor que indica si los mensajes se envían almacenados en búfer o transmitidos en secuencias.

TransferMode

Obtiene o establece un valor que indica si los mensajes se envían almacenados en búfer o transmitidos en secuencias.

(Heredado de HttpBindingBase)
UseDefaultWebProxy

Obtiene o establece un valor que indica si se debería usar el proxy HTTP del sistema configurado automáticamente, si está disponible.

UseDefaultWebProxy

Obtiene o establece un valor que indica si se debería usar el proxy HTTP del sistema configurado automáticamente, si está disponible.

(Heredado de HttpBindingBase)

Métodos

BuildChannelFactory<TChannel>(BindingParameterCollection)

Compila la pila de generador de canales en el cliente que crea un tipo especificado de canal y satisface las características especificadas por una colección de parámetros de enlace.

BuildChannelFactory<TChannel>(BindingParameterCollection)

Compila la pila de generador de canales en el cliente que crea un tipo especificado de canal y satisface las características especificadas por una colección de parámetros de enlace.

(Heredado de Binding)
BuildChannelFactory<TChannel>(Object[])

Compila la pila de generador de canales en el cliente que crea un tipo especificado de canal y eso satisface las características especificadas por una matriz de objetos.

(Heredado de Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y eso satisface las características especificadas por una colección de parámetros de enlace.

(Heredado de Binding)
BuildChannelListener<TChannel>(Object[])

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.

(Heredado de Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.

(Heredado de Binding)
BuildChannelListener<TChannel>(Uri, Object[])

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.

(Heredado de Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.

(Heredado de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.

(Heredado de Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.

(Heredado de Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])

Compila el agente de escucha del canal en el servicio que acepta un tipo especificado de canal y satisface las características especificadas.

(Heredado de Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)

Devuelve un valor que indica si el enlace actual puede compilar una pila de generador de canales en el cliente que satisfaga la colección especificada de parámetros de enlace.

(Heredado de Binding)
CanBuildChannelFactory<TChannel>(Object[])

Devuelve un valor que indica si el enlace actual puede compilar una pila de generador de canales en el cliente que satisfaga los requisitos especificados por una matriz de objetos.

(Heredado de Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)

Devuelve un valor que indica si el enlace actual puede compilar un agente de escucha de canal en el servicio que satisfaga la colección especificada de parámetros de enlace.

(Heredado de Binding)
CanBuildChannelListener<TChannel>(Object[])

Devuelve un valor que indica si el enlace actual puede compilar un agente de escucha de canal en el servicio que satisfaga la colección especificada de parámetros de enlace.

(Heredado de Binding)
CreateBindingElements()

Crea y devuelve una colección ordenada de elementos de enlace contenidos en el enlace actual.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetProperty<T>(BindingParameterCollection)

Devuelve un objeto escrito solicitado de la capa adecuada en la pila de enlace si está presente.

(Heredado de Binding)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ShouldSerializeEnableHttpCookieContainer()

Indica si el contenedor de cookies HTTP debe habilitar la serialización.

ShouldSerializeName()

Devuelve un valor si se debe serializar el nombre del enlace.

(Heredado de Binding)
ShouldSerializeNamespace()

Devuelve un valor si se debe serializar el espacio de nombres.

(Heredado de Binding)
ShouldSerializeReaderQuotas()

Devuelve si se deben serializar los valores de restricción situados en la complejidad de la estructura de mensaje SOAP.

ShouldSerializeReaderQuotas()

Devuelve si se deben serializar los valores de restricción situados en la complejidad de la estructura de mensaje SOAP.

(Heredado de HttpBindingBase)
ShouldSerializeSecurity()

Devuelve si la configuración de seguridad se debe serializar en función de si la serialización ya se produce; por ejemplo, a nivel de mensaje o de transporte.

ShouldSerializeTextEncoding()

Devuelve si se debe serializar la configuración para la codificación de texto.

ShouldSerializeTextEncoding()

Devuelve si se debe serializar la configuración para la codificación de texto.

(Heredado de HttpBindingBase)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Implementaciones de interfaz explícitas

IBindingRuntimePreferences.ReceiveSynchronously

Obtiene un valor que indica si las solicitudes de entrada se administran de forma sincrónica o asincrónica.

IBindingRuntimePreferences.ReceiveSynchronously

Obtiene un valor que indica si las solicitudes de entrada se administran de forma sincrónica o asincrónica.

(Heredado de HttpBindingBase)

Se aplica a