OperationBehaviorAttribute.ReleaseInstanceMode Propriedade

Definição

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.dll

Obtém ou define um valor que indica quando reciclar o objeto de serviço no curso de uma invocação de operação.

public:
 property System::ServiceModel::ReleaseInstanceMode ReleaseInstanceMode { System::ServiceModel::ReleaseInstanceMode get(); void set(System::ServiceModel::ReleaseInstanceMode value); };

public System.ServiceModel.ReleaseInstanceMode ReleaseInstanceMode { get; set; }

member this.ReleaseInstanceMode : System.ServiceModel.ReleaseInstanceMode with get, set

Public Property ReleaseInstanceMode As ReleaseInstanceMode

Valor da propriedade

ReleaseInstanceMode

Um dos valores de ReleaseInstanceMode. O padrão é None.

Exceções

ArgumentOutOfRangeException

O valor não é um dos valores ReleaseInstanceMode.

Exemplos

O código de exemplo a seguir mostra o uso de objetos de serviço de reciclagem antes e depois de ReleaseInstanceMode uma chamada.

class SampleService : ISampleService
{
  private Guid id;
  private string session;

  public SampleService()
  {
    id = Guid.NewGuid();
    session = OperationContext.Current.SessionId;
    Console.WriteLine("Object {0} has been created.", id);
    Console.WriteLine("For session {0}", session);
  }
  [OperationBehavior(
          ReleaseInstanceMode=ReleaseInstanceMode.BeforeAndAfterCall
  )]
  public string  SampleMethod(string msg)
  {
    Console.WriteLine("The caller said: \"{0}\"", msg);
    Console.WriteLine("For session {0}", OperationContext.Current.SessionId);
    return "The service greets you: " + msg;
  }

  ~SampleService()
  {
    Console.WriteLine("Object {0} has been destroyed.", id);
    Console.WriteLine("For session {0}", session);
  }
}

Friend Class SampleService
    Implements ISampleService
  Private id As Guid
  Private session As String

  Public Sub New()
    id = Guid.NewGuid()
    session = OperationContext.Current.SessionId
    Console.WriteLine("Object {0} has been created.", id)
    Console.WriteLine("For session {0}", session)
  End Sub
  <OperationBehavior(ReleaseInstanceMode:=ReleaseInstanceMode.BeforeAndAfterCall)> _
  Public Function SampleMethod(ByVal msg As String) As String Implements ISampleService.SampleMethod
    Console.WriteLine("The caller said: ""{0}""", msg)
    Console.WriteLine("For session {0}", OperationContext.Current.SessionId)
    Return "The service greets you: " & msg
  End Function

  Protected Overrides Sub Finalize()
    Console.WriteLine("Object {0} has been destroyed.", id)
    Console.WriteLine("For session {0}", session)
  End Sub
End Class

Comentários

Use a ReleaseInstanceMode propriedade para especificar quando Windows WCF (Communication Foundation) reciclar um objeto de serviço durante a execução de um método. O comportamento padrão é reciclar um objeto de serviço de acordo com o InstanceContextMode valor. Definir a ReleaseInstanceMode propriedade altera esse comportamento padrão.

Não ReleaseInstanceMode há garantias de threading. Se você precisar ter um novo objeto não modificado quando o serviço for executado, defina a InstanceContextMode propriedade como PerCall.

Em cenários de transação, a ReleaseInstanceMode propriedade geralmente é usada para garantir que dados antigos associados ao objeto de serviço sejam limpos antes de processar uma chamada de método. Você também pode garantir que os objetos de serviço associados às transações sejam reciclados após a conclusão da transação com êxito definindo a ReleaseServiceInstanceOnTransactionComplete propriedade como true.

Você pode escolher os seguintes comportamentos:

• Recicle um objeto de serviço antes que uma operação seja chamada.

• Recicle um objeto de serviço depois que uma operação é chamada.

• Recicle um objeto de serviço antes e depois de uma operação ser chamada.

• Nenhum comportamento de reciclagem.

Você também pode usar OperationBehaviorAttribute para configurar uma operação de contrato de retorno de chamada em um aplicativo cliente duplex. Quando usada em uma operação de retorno de chamada, a ReleaseInstanceMode propriedade deve ser None ou uma exceção InvalidOperationException é lançada em runtime.

Além disso, é importante perceber que, se o serviço for criado passando um objeto de serviço para o ServiceHost.ServiceHost(Object, Uri[]) construtor, o valor dessa propriedade será tratado como se fosse None.