Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

ServiceBehaviorAttribute (Clase)

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

System.Object
  System.Attribute
    System.ServiceModel.ServiceBehaviorAttribute

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

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

El tipo ServiceBehaviorAttribute expone los siguientes miembros.

  NombreDescripción
Método públicoServiceBehaviorAttributeInicializa una nueva instancia de la clase ServiceBehaviorAttribute.
Arriba

  NombreDescripción
Propiedad públicaAddressFilterModeObtiene o establece el AddressFilterMode utilizado por el distribuidor para enrutar los mensajes entrantes al punto final correcto.
Propiedad públicaAutomaticSessionShutdownEspecifica si cerrar automáticamente una sesión cuando un cliente cierra una sesión de salida.
Propiedad públicaConcurrencyModeObtiene o establece si un servicio admite un subproceso, varios subprocesos o llamadas reentrantes.
Propiedad públicaConfigurationNameObtiene o establece el valor usado para localizar el elemento de servicio en un archivo de configuración de la aplicación.
Propiedad públicaEnsureOrderedDispatchObtiene o establece un valor que indica si se garantiza el envío solicitado de servicio.
Propiedad públicaIgnoreExtensionDataObjectObtiene o establece un valor que especifica si enviar o no datos de serialización desconocidos hacia la conexión.
Propiedad públicaIncludeExceptionDetailInFaultsObtiene 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.
Propiedad públicaInstanceContextModeObtiene o establece el valor que indica cuándo se crean los nuevos objetos de servicio.
Propiedad públicaMaxItemsInObjectGraphObtiene o establece el número máximo de elementos permitidos en un objeto serializado.
Propiedad públicaNameObtiene o establece el valor del atributo de nombre del elemento de servicio en el lenguaje de descripción de servicios Web (WSDL).
Propiedad públicaNamespaceObtiene o establece el valor del espacio de nombres de destino del servicio en el lenguaje de descripción de servicios Web (WSDL).
Propiedad públicaReleaseServiceInstanceOnTransactionCompleteObtiene o establece un valor que especifica si se libera el objeto de servicio cuando se completa la transacción actual.
Propiedad públicaTransactionAutoCompleteOnSessionCloseObtiene o establece un valor que especifica si se completan las transacciones pendientes cuando la sesión actual se cierra sin error.
Propiedad públicaTransactionIsolationLevelEspecifica 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.
Propiedad públicaTransactionTimeoutObtiene o establece el período dentro del que una transacción se debe completar.
Propiedad públicaTypeIdCuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Se hereda de Attribute).
Propiedad públicaUseSynchronizationContextObtiene o establece un valor que especifica si utilizar el contexto de sincronización actual para elegir el subproceso de ejecución.
Propiedad públicaValidateMustUnderstandObtiene o establece un valor que especifica si el sistema o la aplicación exige el procesamiento de encabezados MustUnderstand de SOAP.
Arriba

  NombreDescripción
Método públicoEqualsInfraestructura. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Se hereda de Attribute).
Método públicoGetHashCodeDevuelve el código hash de esta instancia. (Se hereda de Attribute).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoGetWellKnownSingletonRecupera un objeto que implementa el servicio y que se utiliza como instancia singleton del servicio o null si no hay ninguna instancia singleton.
Método públicoIsDefaultAttributeCuando se invalida en una clase derivada, indica si el valor de esta instancia es el valor predeterminado para la clase derivada. (Se hereda de Attribute).
Método públicoMatch Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Se hereda de Attribute).
Método públicoSetWellKnownSingletonEspecifica un objeto que implementa el servicio y que se utiliza como instancia singleton del servicio.
Método públicoShouldSerializeConfigurationNameDevuelve un valor que indica si la propiedad ConfigurationName ha cambiado respecto de su valor predeterminado y se debe serializar.
Método públicoShouldSerializeReleaseServiceInstanceOnTransactionCompleteDevuelve un valor que indica si la propiedad ReleaseServiceInstanceOnTransactionComplete ha cambiado respecto de su valor predeterminado y se debe serializar.
Método públicoShouldSerializeTransactionAutoCompleteOnSessionCloseDevuelve un valor que indica si la propiedad TransactionAutoCompleteOnSessionClose ha cambiado respecto de su valor predeterminado y se debe serializar.
Método públicoShouldSerializeTransactionIsolationLevelDevuelve un valor que indica si la propiedad TransactionIsolationLevel ha cambiado respecto de su valor predeterminado y se debe serializar.
Método públicoShouldSerializeTransactionTimeoutDevuelve un valor que indica si la propiedad TransactionTimeout ha cambiado respecto de su valor predeterminado y se debe serializar.
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privado_Attribute.GetIDsOfNamesAsigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoObtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoCount

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.InvokeProporciona acceso a las propiedades y los métodos expuestos por un objeto. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privadoIServiceBehavior.AddBindingParametersPasa objetos de datos personalizados a los enlaces que admiten las propiedades de comportamiento.
Implementación explícita de interfacesMétodo privadoIServiceBehavior.ApplyDispatchBehaviorPersonaliza el tiempo de ejecución del servicio para admitir las propiedades de comportamiento.
Implementación explícita de interfacesMétodo privadoIServiceBehavior.ValidateConfirma que la descripción del servicio y el host del servicio son capaces de admitir el comportamiento.
Arriba

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 multithreading.

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


<configuration>
  <system.serviceModel>
    <services>
      <service  
        name="Microsoft.WCF.Documentation.BehaviorService" 
        behaviorConfiguration="metadataAndDebugEnabled"
      >
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService"/>
          </baseAddresses>
        </host>
        <!--
          Note:
            This example code uses the WSHttpBinding to support transactions using the 
            WS-AtomicTransactions (WS-AT) protocol. WSHttpBinding is configured to use the  
            protocol, but the protocol is not enabled on some computers. Use the xws_reg -wsat+ 
            command to enable the WS-AtomicTransactions protocol in the MSDTC service.          
          -->
        <endpoint 
           contract="Microsoft.WCF.Documentation.IBehaviorService"
           binding="wsHttpBinding"
           bindingConfiguration="wsHttpBindingWithTXFlow"
           address="http://localhost:8080/BehaviorService"
          />
        <endpoint 
           contract="Microsoft.WCF.Documentation.IBehaviorService"
           binding="netTcpBinding"
           bindingConfiguration="netTcpBindingWithTXFlow"
           address="net.tcp://localhost:8081/BehaviorService"
          />
        <endpoint
          address="mex"
          binding="mexHttpBinding"
          contract="IMetadataExchange"
        />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior name="metadataAndDebugEnabled">
          <serviceDebug
            includeExceptionDetailInFaults="true"
          />
          <serviceMetadata
            httpGetEnabled="true"
            httpGetUrl=""
          />
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <!-- binding configuration - configures a WSHttpBinding to require transaction flow -->
    <bindings>
      <wsHttpBinding>
        <binding name="wsHttpBindingWithTXFlow" transactionFlow="true" />
      </wsHttpBinding>
      <netTcpBinding>
        <binding name="netTcpBindingWithTXFlow" transactionFlow="true" />
      </netTcpBinding>
    </bindings>
  </system.serviceModel>
</configuration>



<configuration>
  <system.serviceModel>
    <services>
      <service  
        name="Microsoft.WCF.Documentation.BehaviorService" 
        behaviorConfiguration="metadataAndDebugEnabled"
      >
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService"/>
          </baseAddresses>
        </host>
        <!--
          Note:
            This example code uses the WSHttpBinding to support transactions using the 
            WS-AtomicTransactions (WS-AT) protocol. WSHttpBinding is configured to use the  
            protocol, but the protocol is not enabled on some computers. Use the xws_reg -wsat+ 
            command to enable the WS-AtomicTransactions protocol in the MSDTC service.          
          -->
        <endpoint 
           contract="Microsoft.WCF.Documentation.IBehaviorService"
           binding="wsHttpBinding"
           bindingConfiguration="wsHttpBindingWithTXFlow"
           address="http://localhost:8080/BehaviorService"
          />
        <endpoint 
               contract="Microsoft.WCF.Documentation.IBehaviorService"
               binding="netTcpBinding"
               bindingConfiguration="netTcpBindingWithTXFlow"
               address="net.tcp://localhost:8081/BehaviorService"
          />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior name="metadataAndDebugEnabled">
          <serviceDebug
            includeExceptionDetailInFaults="true"
          />
          <serviceMetadata
            httpGetEnabled="true"
            httpGetUrl=""
          />
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <!-- binding configuration - configures a WSHttpBinding to require transaction flow -->
    <bindings>
      <wsHttpBinding>
        <binding name="wsHttpBindingWithTXFlow" transactionFlow="true" />
      </wsHttpBinding>
      <netTcpBinding>
        <binding name="netTcpBindingWithTXFlow" transactionFlow="true" />
      </netTcpBinding>
    </bindings>
  </system.serviceModel>
</configuration>


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft