BasicHttpBinding Clase

Definición

Espacio de nombres:: System.ServiceModel

Ensamblados:: System.ServiceModel.dll, System.ServiceModel.Http.dll

Ensamblado:: System.ServiceModel.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un enlace que un servicio de Windows Communication Foundation (WCF) puede usar para configurar y exponer puntos de conexión que pueden comunicarse con clientes y servicios web basados en ASMX y otros servicios que se ajustan al perfil básico 1.1 de WS-I.

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: Object

Binding

HttpBindingBase
BasicHttpBinding

Herencia: Object

Binding
BasicHttpBinding

Derivado: System.ServiceModel.BasicHttpContextBinding

Implementaciones: IBindingRuntimePreferences

Ejemplos

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

En el ejemplo siguiente se muestra cómo configurar BasicHttpBindingmediante programación .

[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 usa HTTP como transporte para enviar mensajes SOAP 1.1. Un servicio puede usar este enlace para exponer puntos de conexión que se ajustan a WS-I BP 1.1, como aquellos a los que acceden los clientes ASMX. Del mismo modo, un cliente puede usar el BasicHttpBinding para comunicarse con los servicios que exponen puntos de conexión que se ajustan a WS-I BP 1.1, como servicios web ASMX o servicios Windows Communication Foundation (WCF) configurados con el BasicHttpBinding.

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

Constructores

Nombre	Description
BasicHttpBinding()	Inicializa una nueva instancia de la clase BasicHttpBinding.
BasicHttpBinding(BasicHttpSecurityMode)	Inicializa una nueva instancia de la BasicHttpBinding clase con un tipo de seguridad especificado utilizado por el enlace.
BasicHttpBinding(String)	Inicializa una nueva instancia de la BasicHttpBinding clase con un enlace especificado por su nombre de configuración.

Propiedades

Nombre	Description
AllowCookies	Obtiene o establece un valor que indica si el cliente acepta cookies y los propaga en solicitudes futuras.
AllowCookies	Obtiene o establece un valor que indica si el cliente acepta cookies y los propaga en solicitudes futuras. (Heredado de HttpBindingBase)
BypassProxyOnLocal	Obtiene o establece un valor que indica si se va a omitir el servidor proxy para las direcciones locales.
BypassProxyOnLocal	Obtiene o establece un valor que indica si se va a omitir 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 cookies HTTP está habilitado.
EnvelopeVersion	Obtiene la versión de SOAP que se usa para los mensajes procesados por este enlace.
EnvelopeVersion	Obtiene la versión de SOAP que se usa para los mensajes procesados por este enlace. (Heredado de HttpBindingBase)
HostNameComparisonMode	Obtiene o establece un valor que indica si el nombre de host se usa para llegar al servicio al buscar coincidencias con el URI.
HostNameComparisonMode	Obtiene o establece un valor que indica si el nombre de host se usa para llegar al servicio al buscar coincidencias con el URI. (Heredado de HttpBindingBase)
MaxBufferPoolSize	Obtiene o establece la cantidad máxima de memoria, en bytes, que el administrador de los búferes de mensajes asigna para su uso.
MaxBufferPoolSize	Obtiene o establece la cantidad máxima de memoria, en bytes, que el administrador de los búferes de mensajes asigna para su uso. (Heredado de HttpBindingBase)
MaxBufferSize	Obtiene o establece el tamaño máximo, en bytes, de un búfer que recibe mensajes del canal.
MaxBufferSize	Obtiene o establece el tamaño máximo, en bytes, de 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 Text para codificar mensajes SOAP.
MessageVersion	Obtiene la versión del mensaje utilizada por 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 se abra una conexión 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 sobre la complejidad de los mensajes SOAP que pueden procesar los puntos de conexión configurados con este enlace.
ReaderQuotas	Obtiene o establece las restricciones en la complejidad de los mensajes SOAP que los puntos de conexión configurados con este enlace pueden procesar. (Heredado de HttpBindingBase)
ReceiveTimeout	Obtiene o establece el intervalo de tiempo que una conexión puede permanecer inactiva, durante la cual no se recibe ningún mensaje de aplicación, antes de quitarla. (Heredado de Binding)
Scheme	Obtiene el esquema de transporte de URI para los canales y agentes de escucha configurados con este enlace.
Scheme	Obtiene el esquema de transporte de URI para los canales y agentes de escucha configurados con este enlace. (Heredado de HttpBindingBase)
Security	Obtiene el tipo de seguridad usado con este enlace.
SendTimeout	Obtiene o establece el intervalo de tiempo proporcionado para que se complete una operación de escritura 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 se envían mensajes almacenados en búfer o transmitidos.
TransferMode	Obtiene o establece un valor que indica si se envían mensajes almacenados en búfer o transmitidos. (Heredado de HttpBindingBase)
UseDefaultWebProxy	Obtiene o establece un valor que indica si se debe usar el proxy HTTP configurado automáticamente del sistema, si está disponible.
UseDefaultWebProxy	Obtiene o establece un valor que indica si se debe usar el proxy HTTP configurado automáticamente del sistema, si está disponible. (Heredado de HttpBindingBase)

Métodos

Nombre	Description
BuildChannelFactory<TChannel>(BindingParameterCollection)	Compila la pila de generador de canales en el cliente que crea un tipo de canal especificado y que 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 de canal especificado y que satisface las características especificadas por una colección de parámetros de enlace. (Heredado de Binding)
BuildChannelFactory<TChannel>(Object[])	Compila la pila del generador de canales en el cliente que crea un tipo de canal especificado y que satisface las características especificadas por una matriz de objetos. (Heredado de Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	Compila el agente de escucha de canal en el servicio que acepta un tipo de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que 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 de canal especificado y que satisface las características especificadas. (Heredado de Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	Devuelve un valor que indica si el enlace actual puede crear una pila de generador de canales en el cliente que satisfaga la colección de parámetros de enlace especificados. (Heredado de Binding)
CanBuildChannelFactory<TChannel>(Object[])	Devuelve un valor que indica si el enlace actual puede crear una pila de generador de canales en el cliente que cumpla los requisitos especificados por una matriz de objetos. (Heredado de Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	Devuelve un valor que indica si el enlace actual puede crear una pila del agente de escucha de canal en el servicio que satisface la colección de parámetros de enlace especificados. (Heredado de Binding)
CanBuildChannelListener<TChannel>(Object[])	Devuelve un valor que indica si el enlace actual puede crear una pila del agente de escucha de canal en el servicio que cumpla los criterios especificados en una matriz de objetos. (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 al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetProperty<T>(BindingParameterCollection)	Devuelve un objeto con tipo solicitado, si está presente, de la capa adecuada en la pila de enlace. (Heredado de Binding)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ShouldSerializeEnableHttpCookieContainer()	Indica si el contenedor de cookies http debe habilitar la serialización.
ShouldSerializeName()	Devuelve si se debe serializar el nombre del enlace. (Heredado de Binding)
ShouldSerializeNamespace()	Devuelve si se debe serializar el espacio de nombres del enlace. (Heredado de Binding)
ShouldSerializeReaderQuotas()	Devuelve si se deben serializar los valores de restricción colocados en la complejidad de la estructura de mensajes SOAP.
ShouldSerializeReaderQuotas()	Devuelve si se deben serializar los valores de restricción colocados en la complejidad de la estructura de mensajes SOAP. (Heredado de HttpBindingBase)
ShouldSerializeSecurity()	Devuelve si se debe serializar la configuración de seguridad en función de si la serialización ya se produce, por ejemplo, en el nivel de mensaje o transporte.
ShouldSerializeTextEncoding()	Devuelve si se debe serializar la configuración de la codificación de texto.
ShouldSerializeTextEncoding()	Devuelve si se debe serializar la configuración de 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

Nombre	Description
IBindingRuntimePreferences.ReceiveSynchronously	Obtiene un valor que indica si las solicitudes entrantes se controlan de forma sincrónica o asincrónica.
IBindingRuntimePreferences.ReceiveSynchronously	Obtiene un valor que indica si las solicitudes entrantes se controlan de forma sincrónica o asincrónica. (Heredado de HttpBindingBase)

Se aplica a

Comentarios

¿Le ha resultado útil esta página?