OperationBehaviorAttribute.ReleaseInstanceMode Свойство

Определение

Пространство имен:

System.ServiceModel

Сборка:

System.ServiceModel.dll

Возвращает или задает значение, указывающее, когда удалять объект службы в процессе вызова операции.

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

Одно из значений перечисления ReleaseInstanceMode. Значение по умолчанию — None.

Исключения

ArgumentOutOfRangeException

Данное значение не является одним из значений ReleaseInstanceMode.

Примеры

В следующем примере кода показано использование перечисления ReleaseInstanceMode для удаления объектов службы перед вызовом и после вызова.

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) перезапускает объект службы в ходе выполнения метода. По умолчанию объект службы удаляется в соответствии со значением свойства InstanceContextMode. Задание значения ReleaseInstanceMode изменяет это поведение по умолчанию.

Режим ReleaseInstanceMode не дает гарантий потоков. Если требуется новый неизмененный объект при выполнении службы, задайте для свойства InstanceContextMode значение PerCall.

В сценариях транзакции свойство ReleaseInstanceMode часто используется для удаления старых данных, связанных с объектом службы, до обработки вызова метода. Также можно обеспечить удаление объектов службы, связанных с транзакциями, после успешного выполнения транзакции, присвоив свойству ReleaseServiceInstanceOnTransactionComplete значение true.

Присутствуют следующие варианты выбора поведений.

• Удаление объекта службы перед вызовом операции.

• Удаление объекта службы после вызова операции.

• Удаление объекта службы как перед, так и после вызова операции.

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

Также можно использовать атрибут OperationBehaviorAttribute, чтобы настроить операцию контракта обратного вызова в дуплексном клиентском приложении. При использовании в операции обратного вызова свойство ReleaseInstanceMode должно иметь значение None, или в среде выполнения выводится исключение InvalidOperationException.

Кроме того, важно понимать, что если служба создается путем передачи объекта службы в конструктор ServiceHost.ServiceHost(Object, Uri[]), значение этого свойства считается None.