ReliableSessionBindingElement Clase

Definición

Representa el elemento de enlace que puede generar los canales de envío y recepción requeridos para una sesión confiable entre los extremos.Represents the binding element that can produce the sending and receiving channels required for a reliable session between endpoints.

public ref class ReliableSessionBindingElement sealed : System::ServiceModel::Channels::BindingElement, System::ServiceModel::Description::IPolicyExportExtension
public sealed class ReliableSessionBindingElement : System.ServiceModel.Channels.BindingElement, System.ServiceModel.Description.IPolicyExportExtension
type ReliableSessionBindingElement = class
    inherit BindingElement
    interface IPolicyExportExtension
Public NotInheritable Class ReliableSessionBindingElement
Inherits BindingElement
Implements IPolicyExportExtension
Herencia
ReliableSessionBindingElement
Implementaciones

Ejemplos

ReliableSessionBindingElement se puede agregar a cualquier enlace personalizado.The ReliableSessionBindingElement can be added to any custom binding. Esto se hace utilizando los elementos de configuración siguientes.This is done using the following configuration elements.

<bindings>  
    <customBinding>  
        <binding configurationName="ReliabilityHTTP">  
            <reliableSession/>  
        </binding>  
    </customBinding>  
</bindings>  

En el ejemplo de código siguiente se muestra cómo usar ReliableSessionBindingElement en el código.The following sample code demonstrates how to use ReliableSessionBindingElement in code.

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

// Create a ServiceHost for the CalculatorService type and provide the base address.
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
{
    // Create a custom binding that contains two binding elements.
    ReliableSessionBindingElement reliableSession = new ReliableSessionBindingElement();
    reliableSession.Ordered = true;

    HttpTransportBindingElement httpTransport = new HttpTransportBindingElement();
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous;
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;

    CustomBinding binding = new CustomBinding(reliableSession, httpTransport);

    // Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, "");

    // Add a MEX endpoint.
    ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
    smb.HttpGetEnabled = true;
    smb.HttpGetUrl = new Uri("http://localhost:8001/servicemodelsamples");
    serviceHost.Description.Behaviors.Add(smb);
  
    // 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();
}
Dim baseAddress As New Uri("http://localhost:8000/servicemodelsamples/service")

' Create a ServiceHost for the CalculatorService type and provide the base address.
Using serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)
    ' Create a custom binding that contains two binding elements.
    Dim reliableSession As New ReliableSessionBindingElement()
    reliableSession.Ordered = True

    Dim httpTransport As New HttpTransportBindingElement()
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard

    Dim binding As New CustomBinding(reliableSession, httpTransport)

    ' Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(GetType(ICalculator), binding, "")

    ' Add a MEX endpoint.
    Dim smb As New ServiceMetadataBehavior()
    smb.HttpGetEnabled = True
    smb.HttpGetUrl = New Uri("http://localhost:8001/servicemodelsamples")
    serviceHost.Description.Behaviors.Add(smb)

    ' 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()
End Using

Comentarios

Proporciona las sesiones y puede permitir, si se desea, la entrega ordenada de mensajes.Provides sessions and optionally provides ordered message delivery. Esta sesión implementada puede cruzar SOAP y los intermediarios de transporte.This implemented session can cross SOAP and transport intermediaries.

Cada elemento de enlace representa un paso del procesamiento al enviar y recibir mensajes.Each binding element represents a processing step when sending or receiving messages. En tiempo de ejecución, los elementos de enlace crean los generadores de canales y las escuchas que son necesarios para compilar pilas de canal entrantes y salientes necesarias para enviar y recibir los mensajes.At runtime, binding elements create the channel factories and listeners that are necessary to build outgoing and incoming channel stacks required to send and receive messages. ReliableSessionBindingElement proporciona un nivel opcional en la pila que puede establecer una sesión confiable entre los extremos y configurar el comportamiento de esta sesión.The ReliableSessionBindingElement provides an optional layer in the stack that can establish a reliable session between endpoints and configure the behavior of this session.

ReliableSessionBindingElement se proporciona en los enlaces estándar en la tabla siguiente.The ReliableSessionBindingElement is provided on the standard bindings in the following table.

EnlacesBinding DefaultDefault
NetTcpBinding DesactivadoOff
WSHttpBinding DesactivadoOff
WSDualHttpBinding On (se requiere)On (required)

Constructores

ReliableSessionBindingElement()

Inicializa una nueva instancia de la clase ReliableSessionBindingElement.Initializes a new instance of the ReliableSessionBindingElement class.

ReliableSessionBindingElement(Boolean)

Inicializa una instancia nueva de la clase ReliableSessionBindingElement que especifica si la entrega del mensaje debe conservar el orden de envío de los mensajes.Initializes a new instance of the ReliableSessionBindingElement class that specifies whether message delivery must preserve the order in which messages are sent.

Propiedades

AcknowledgementInterval

Obtiene o establece el intervalo de tiempo que un destino espera antes de enviar una confirmación al origen del mensaje en canales de confianza creados por el generador.Gets or sets the interval of time that a destination waits before sending an acknowledgment to the message source on reliable channels that are created by the factory.

FlowControlEnabled

Obtiene o establece un valor que indica si la sesión confiable tiene habilitado el control de flujo.Gets or sets a value that indicates whether the reliable session has flow control enabled.

InactivityTimeout

Obtiene o establece un intervalo de tiempo durante el que un servicio permanece inactivo antes de cerrarse.Gets or sets an interval of time that a service remains inactive before closing.

MaxPendingChannels

Obtiene o establece el número máximo de canales que pueden estar pendientes durante la sesión confiable.Gets or sets the largest number of channels that can be pending during the reliable session.

MaxRetryCount

Obtiene o establece el número máximo de veces que se intenta transferir un mensaje durante la sesión confiable.Gets or sets the maximum number of times that a message attempts to be transferred during the reliable session.

MaxTransferWindowSize

Obtiene o establece o el número máximo de mensajes que pueden existir en el búfer de envío o en el búfer de recepción.Gets or sets the largest number of messages that can exist in either the send buffer or the receive buffer.

Ordered

Obtiene o establece un valor que indica si la entrega del mensaje debe conservar el orden de envío de los mensajes.Gets or sets a value that indicates whether message delivery must preserve the order in which messages are sent.

ReliableMessagingVersion

Obtiene o establece la versión de WS-ReliableMessaging especificada por el elemento de enlace.Gets or sets the version of WS-ReliableMessaging specified by the binding element.

Métodos

BuildChannelFactory<TChannel>(BindingContext)

Devuelve un generador que crea un canal de un tipo especificado que admite una sesión confiable.Returns a factory that creates a channel of a specified type that supports a reliable session.

BuildChannelListener<TChannel>(BindingContext)

Devuelve un tipo de escucha que acepta un canal de un tipo especificado que admite una sesión confiable.Returns a listener that accepts a channel of a specified type that supports a reliable session.

CanBuildChannelFactory<TChannel>(BindingContext)

Devuelve un valor que indica si el generador de canales se puede compilar para el canal y el contexto siempre que pueda admitir una sesión confiable.Returns a value that indicates whether the channel factory can be built for the channel and context provided that can support a reliable session.

CanBuildChannelListener<TChannel>(BindingContext)

Devuelve un valor que indica si se puede compilar el agente de escucha del canal para el canal y el contexto siempre que pueda admitir una sesión confiable.Returns a value that indicates whether the channel listener can be built for the channel and context provided that can support a reliable session.

Clone()

Crea una copia del elemento de enlace de la sesión confiable actual.Creates a copy of the current reliable session binding element.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene una propiedad del tipo especificado de su contexto de enlace.Gets a property of the specified type from its binding context.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Asigna la información contenida en el elemento de enlace de la sesión confiable en los elementos de WSDL que permiten a un extremo remoto tener acceso al servicio con una sesión confiable.Maps the information contained in the reliable session binding element into the WSDL elements that enable a remote endpoint to access the service with a reliable session.

Se aplica a