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.