Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase ServiceBehaviorAttribute

 

Especifica el comportamiento de ejecución interno de una implementación de contrato de servicio.

Espacio de nombres:   System.ServiceModel
Ensamblado:  System.ServiceModel (en System.ServiceModel.dll)

System.Object
  System.Attribute
    System.ServiceModel.ServiceBehaviorAttribute

[AttributeUsageAttribute(AttributeTargets.Class)]
public sealed class ServiceBehaviorAttribute : Attribute, IServiceBehavior

NombreDescripción
System_CAPS_pubmethodServiceBehaviorAttribute()

Inicializa una nueva instancia de la clase ServiceBehaviorAttribute.

NombreDescripción
System_CAPS_pubpropertyAddressFilterMode

Obtiene o establece el AddressFilterMode utilizado por el distribuidor para enrutar los mensajes entrantes al punto final correcto.

System_CAPS_pubpropertyAutomaticSessionShutdown

Especifica si cerrar automáticamente una sesión cuando un cliente cierra una sesión de salida.

System_CAPS_pubpropertyConcurrencyMode

Obtiene o establece si un servicio admite un subproceso, varios subprocesos o llamadas reentrantes.

System_CAPS_pubpropertyConfigurationName

Obtiene o establece el valor utilizado para buscar el elemento de servicio en un archivo de configuración de la aplicación.

System_CAPS_pubpropertyEnsureOrderedDispatch

Obtiene o establece un valor que indica si se garantiza el envío solicitado de servicio.

System_CAPS_pubpropertyIgnoreExtensionDataObject

Obtiene o establece un valor que especifica si enviar o no datos de serialización desconocidos hacia la conexión.

System_CAPS_pubpropertyIncludeExceptionDetailInFaults

Obtiene o establece un valor que especifica que las excepciones de ejecución generales no controladas se convertirán en una System.ServiceModel.FaultException<TDetail> de tipo System.ServiceModel.ExceptionDetail, y se enviarán como mensaje de error. Establezca este valor como true sólo durante el desarrollo para solucionar problemas de un servicio.

System_CAPS_pubpropertyInstanceContextMode

Obtiene o establece el valor que indica cuándo se crean los nuevos objetos de servicio.

System_CAPS_pubpropertyMaxItemsInObjectGraph

Obtiene o establece el número máximo de elementos permitido en un objeto serializado.

System_CAPS_pubpropertyName

Obtiene o establece el valor del atributo de nombre del elemento de servicio en el lenguaje de descripción de servicios Web (WSDL).

System_CAPS_pubpropertyNamespace

Obtiene o establece el valor del espacio de nombres de destino del servicio en el lenguaje de descripción de servicios Web (WSDL).

System_CAPS_pubpropertyReleaseServiceInstanceOnTransactionComplete

Obtiene o establece un valor que especifica si se libera el objeto de servicio cuando se completa la transacción actual.

System_CAPS_pubpropertyTransactionAutoCompleteOnSessionClose

Obtiene o establece un valor que especifica si se completan las transacciones pendientes cuando la sesión actual se cierra sin error.

System_CAPS_pubpropertyTransactionIsolationLevel

Especifica el nivel de aislamiento de transacción para las nuevas transacciones creadas dentro del servicio y las transacciones entrantes que han fluido desde un cliente.

System_CAPS_pubpropertyTransactionTimeout

Obtiene o establece el período dentro del que una transacción se debe completar.

System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

System_CAPS_pubpropertyUseSynchronizationContext

Obtiene o establece un valor que especifica si utilizar el contexto de sincronización actual para elegir el subproceso de ejecución.

System_CAPS_pubpropertyValidateMustUnderstand

Obtiene o establece un valor que especifica si el sistema o la aplicación exige el procesamiento de encabezados MustUnderstand de SOAP.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un valor que indica si esta instancia es igual que un objeto especificado.(Heredado de Attribute).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Heredado de Attribute).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetWellKnownSingleton()

Recupera un objeto que implementa el servicio y que se utiliza como instancia singleton del servicio o null si no hay ninguna instancia singleton.

System_CAPS_pubmethodIsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.(Heredado de Attribute).

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.(Heredado de Attribute).

System_CAPS_pubmethodSetWellKnownSingleton(Object)

Especifica un objeto que implementa el servicio y que se utiliza como instancia singleton del servicio.

System_CAPS_pubmethodShouldSerializeConfigurationName()

Devuelve un valor que indica si la propiedad ConfigurationName ha cambiado respecto de su valor predeterminado y se debe serializar.

System_CAPS_pubmethodShouldSerializeReleaseServiceInstanceOnTransactionComplete()

Devuelve un valor que indica si la propiedad ReleaseServiceInstanceOnTransactionComplete ha cambiado respecto de su valor predeterminado y se debe serializar.

System_CAPS_pubmethodShouldSerializeTransactionAutoCompleteOnSessionClose()

Devuelve un valor que indica si la propiedad TransactionAutoCompleteOnSessionClose ha cambiado respecto de su valor predeterminado y se debe serializar.

System_CAPS_pubmethodShouldSerializeTransactionIsolationLevel()

Devuelve un valor que indica si la propiedad TransactionIsolationLevel ha cambiado respecto de su valor predeterminado y se debe serializar.

System_CAPS_pubmethodShouldSerializeTransactionTimeout()

Devuelve un valor que indica si la propiedad TransactionTimeout ha cambiado respecto de su valor predeterminado y se debe serializar.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)

Pasa objetos de datos personalizados a los enlaces que admiten las propiedades de comportamiento.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)

Personaliza el tiempo de ejecución del servicio para admitir las propiedades de comportamiento.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIServiceBehavior.Validate(ServiceDescription, ServiceHostBase)

Confirma que la descripción del servicio y el host de servicio son capaces de admitir el comportamiento.

Aplique el atributo ServiceBehaviorAttribute a una implementación del servicio para especificar el comportamiento de ejecución de todo el servicio. (Para especificar el comportamiento de ejecución en el nivel de método, utilice el atributo OperationBehaviorAttribute.) Este atributo sólo se puede aplicar a las implementaciones de servicio. Para obtener ejemplos prácticos, consulte Service Behaviors Samples.

Las propiedades ServiceBehaviorAttribute son una característica de modelo de programación Windows Communication Foundation (WCF) que habilita características comunes que, de otro modo, tendrían que implementar los programadores. Para obtener más información sobre estos y otros comportamientos, consulte Especificación del comportamiento en tiempo de ejecución del servicio. Para obtener más información sobre las propiedades en tiempo de ejecución subyacentes que establecen algunas de las propiedades siguientes, vea Extensión de ServiceHost y la capa de modelos de servicios.

  • La propiedad AddressFilterMode especifica el tipo de filtro que el sistema del distribuidor utiliza para buscar el extremo que administra las solicitudes.

  • La propiedad AutomaticSessionShutdown cierra automáticamente la sesión cuando se cierra el canal y el servicio ha acabado de procesar todos los mensajes restantes.

  • La propiedad ConcurrencyMode controla el modelo de subprocesos interno, habilitando la compatibilidad para los servicios reentrantes o multiproceso.

  • La propiedad ConfigurationName se utiliza para declarar un nombre para su utilización en el atributo name del elemento <service> en un archivo de configuración.

  • La propiedad IgnoreExtensionDataObject permite que el tiempo de ejecución omita información de serialización adicional que no se exige para procesar el mensaje.

  • La propiedad IncludeExceptionDetailInFaults especifica si las excepciones no controladas de un servicio se devuelven como errores SOAP. Esto se hace sólo con fines de depuración.

  • La propiedad InstanceContextMode especifica si los servicios y sus objetos de servicio serán reciclados durante un intercambio con un cliente y cuándo lo serán.

  • La propiedad MaxItemsInObjectGraph para limitar el número de elementos en un gráfico de objetos que se serializan.

  • Las propiedades Name y Namespace controlan el nombre y el espacio de nombres de la expresión WSDL del elemento de servicio.

  • La propiedad ReleaseServiceInstanceOnTransactionComplete especifica si el objeto de servicio se recicla cuando se completa una transacción.

  • La propiedad TransactionAutoCompleteOnSessionClose especifica si se completan las transacciones pendientes cuando la sesión se cierra.

  • La propiedad TransactionIsolationLevel especifica el nivel del aislamiento de transacción que el contrato admite.

  • La propiedad TransactionTimeout especifica el período de tiempo dentro del que una nueva transacción creada en el servicio debe completarse o se anula.

  • La propiedad UseSynchronizationContext indica si sincronizar automáticamente las llamadas al método entrantes con el subproceso de la interfaz de usuario.

  • La propiedad ValidateMustUnderstand informa al sistema sobre si debe confirmar que los encabezados SOAP marcados como MustUnderstand han sido, de hecho, entendidos.

La propiedad IncludeExceptionDetailInFaults también se puede establecer mediante un archivo de configuración de aplicación. Para obtener información detallada, vea IncludeExceptionDetailInFaults.

En el ejemplo de código siguiente se muestran las propiedades ServiceBehaviorAttribute. La clase BehaviorService utiliza el atributo ServiceBehaviorAttribute para indicar que:

  • Se recicla el objeto de servicio cuando se completa la transacción.

  • Hay un objeto de servicio para cada sesión.

  • La instancia del servicio es de subproceso único y no admite llamadas reentrantes.

Además, en el nivel de la operación, los valores OperationBehaviorAttribute indican que el método TxWork da de alta automáticamente las transacciones de flujo o crea una transacción nueva para hacer el trabajo y que se confirma la transacción automáticamente si no se produce una excepción no controlada.

using System;
using System.ServiceModel;
using System.Transactions;

namespace Microsoft.WCF.Documentation
{
  [ServiceContract(
    Namespace="http://microsoft.wcf.documentation", 
    SessionMode=SessionMode.Required
  )]
  public interface IBehaviorService
  {
    [OperationContract]
    string TxWork(string message);
  }

  // Note: To use the TransactionIsolationLevel property, you 
  // must add a reference to the System.Transactions.dll assembly.
  /* The following service implementation:
   *   -- Processes messages on one thread at a time
   *   -- Creates one service object per session
   *   -- Releases the service object when the transaction commits
   */
  [ServiceBehavior(
    ConcurrencyMode=ConcurrencyMode.Single,
    InstanceContextMode=InstanceContextMode.PerSession,
    ReleaseServiceInstanceOnTransactionComplete=true
  )]
  public class BehaviorService : IBehaviorService, IDisposable
  {
    Guid myID;

    public BehaviorService()
    {
      myID = Guid.NewGuid();
      Console.WriteLine(
        "Object "
        + myID.ToString()
        + " created.");
    }

    /*
     * The following operation-level behaviors are specified:
     *   -- The executing transaction is committed when
     *        the operation completes without an 
     *        unhandled exception
     *   -- Always executes under a flowed transaction.
     */
    [OperationBehavior(
      TransactionAutoComplete = true,
      TransactionScopeRequired = true
    )]
    [TransactionFlow(TransactionFlowOption.Mandatory)]
    public string TxWork(string message)
    {
      // Do some transactable work.
      Console.WriteLine("TxWork called with: " + message);
      // Display transaction information.

      TransactionInformation info = Transaction.Current.TransactionInformation;
      Console.WriteLine("The distributed tx ID: {0}.", info.DistributedIdentifier);
      Console.WriteLine("The tx status: {0}.", info.Status);
      return String.Format("Hello. This was object {0}.",myID.ToString()) ;
    }

    public void Dispose()
    {
      Console.WriteLine(
        "Service "
        + myID.ToString()
        + " is being recycled."
      );
    }
  }
}

El enlace subyacente debe admitir transacciones de flujo para que el ejemplo de código siguiente se ejecute correctamente. Para admitir transacciones de flujo con WSHttpBinding, por ejemplo, establezca la propiedad TransactionFlow como true en el código o en un archivo de configuración de la aplicación. El ejemplo de código siguiente muestra el archivo de configuración para el ejemplo anterior:

.NET Framework
Disponible desde 3.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: