OperationBehaviorAttribute.ReleaseInstanceMode Свойство

Определение

Возвращает или задает значение, указывающее, когда удалять объект службы в процессе вызова операции.Gets or sets a value that indicates when in the course of an operation invocation to recycle the service object.

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

Значение свойства

Одно из значений перечисления ReleaseInstanceMode.One of the ReleaseInstanceMode values. Значение по умолчанию — None.The default is None.

Исключения

Данное значение не является одним из значений ReleaseInstanceMode.The value is not one of the ReleaseInstanceMode values.

Примеры

В следующем примере кода показано использование перечисления ReleaseInstanceMode для удаления объектов службы перед вызовом и после вызова.The following example code shows the use of ReleaseInstanceMode to recycle service objects both before and after a call.

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

Комментарии

ReleaseInstanceMode Используйте свойство, чтобы указать, когда Windows Communication Foundation (WCF) перезапускает объект службы в процессе выполнения метода.Use the ReleaseInstanceMode property to specify when Windows Communication Foundation (WCF) recycles a service object in the course of executing a method. По умолчанию объект службы удаляется в соответствии со значением свойства InstanceContextMode.The default behavior is to recycle a service object according to the InstanceContextMode value. Задание значения ReleaseInstanceMode изменяет это поведение по умолчанию.Setting the ReleaseInstanceMode property changes that default behavior.

Режим ReleaseInstanceMode не дает гарантий потоков.The ReleaseInstanceMode makes no threading guarantees. Если требуется новый неизмененный объект при выполнении службы, задайте для свойства InstanceContextMode значение PerCall.If you must have a new, unmodified object when your service runs, set the InstanceContextMode property to PerCall.

В сценариях транзакции свойство ReleaseInstanceMode часто используется для удаления старых данных, связанных с объектом службы, до обработки вызова метода.In transaction scenarios, the ReleaseInstanceMode property is often used to ensure that old data associated with the service object is cleaned up prior to processing a method call. Также можно обеспечить удаление объектов службы, связанных с транзакциями, после успешного выполнения транзакции, присвоив свойству ReleaseServiceInstanceOnTransactionComplete значение true.You can also ensure that service objects associated with transactions are recycled after the transaction successfully completes by setting the ReleaseServiceInstanceOnTransactionComplete property to true.

Присутствуют следующие варианты выбора поведений.You can choose the following behaviors:

  • Удаление объекта службы перед вызовом операции.Recycle a service object before an operation is called.

  • Удаление объекта службы после вызова операции.Recycle a service object after an operation is called.

  • Удаление объекта службы как перед, так и после вызова операции.Recycle a service object both before and after an operation is called.

  • Отсутствие поведения удаления.No recycling behavior.

Также можно использовать атрибут OperationBehaviorAttribute, чтобы настроить операцию контракта обратного вызова в дуплексном клиентском приложении.You can also use OperationBehaviorAttribute to configure a callback contract operation in a duplex client application. При использовании в операции обратного вызова свойство ReleaseInstanceMode должно иметь значение None, или в среде выполнения выводится исключение InvalidOperationException.When used on a callback operation, the ReleaseInstanceMode property must be None or an InvalidOperationException exception is thrown at runtime.

Кроме того, важно понимать, что если служба создается путем передачи объекта службы в конструктор ServiceHost.ServiceHost(Object, Uri[]), значение этого свойства считается None.In addition, it is important to realize that if the service is created by passing a service object to the ServiceHost.ServiceHost(Object, Uri[]) constructor, the value of this property is treated as if it were None.

Применяется к