OperationBehaviorAttribute.ReleaseInstanceMode Özellik

Tanım

Ad Alanı:

System.ServiceModel

Bütünleştirilmiş Kod:

System.ServiceModel.dll

Hizmet nesnesini geri dönüştürmek için bir işlem çağrısı sırasında ne zaman olduğunu belirten bir değeri alır veya ayarlar.

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

Özellik Değeri

ReleaseInstanceMode

Değerlerden ReleaseInstanceMode biri. Varsayılan değer: None.

Özel durumlar

ArgumentOutOfRangeException

Değer değerlerden ReleaseInstanceMode biri değildir.

Örnekler

Aşağıdaki örnek kod, hizmet nesnelerini bir çağrıdan önce ve sonra geri dönüştürmek için kullanımını ReleaseInstanceMode gösterir.

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

Açıklamalar

ReleaseInstanceMode Windows Communication Foundation'ın (WCF) bir yöntemi yürütme sırasında bir hizmet nesnesini ne zaman geri dönüştüreceğini belirtmek için özelliğini kullanın. Varsayılan davranış, bir hizmet nesnesini değere göre geri dönüştürmektir InstanceContextMode . Özelliğin ReleaseInstanceMode ayarlanması bu varsayılan davranışı değiştirir.

, ReleaseInstanceMode iş parçacığı oluşturma garantisi sağlamaz. Hizmetiniz çalışırken yeni, değiştirilmemiş bir nesneniz olması gerekiyorsa özelliğini olarak PerCallayarlayınInstanceContextMode.

İşlem senaryolarında özelliği genellikle ReleaseInstanceMode bir yöntem çağrısı işlenmeden önce hizmet nesnesiyle ilişkili eski verilerin temizlenmesini sağlamak için kullanılır. ayrıca özelliğini trueolarak ayarlayarak ReleaseServiceInstanceOnTransactionComplete işlemle ilişkili hizmet nesnelerinin işlem başarıyla tamamlandıktan sonra geri dönüştürülmesini de sağlayabilirsiniz.

Aşağıdaki davranışları seçebilirsiniz:

• bir işlem çağrılmadan önce bir hizmet nesnesini geri dönüştür.

• bir işlem çağrıldıktan sonra bir hizmet nesnesini geri dönüştürin.

• Bir işlem çağrıldıktan önce ve çağrıldıktan sonra bir hizmet nesnesini geri dönüştürin.

• Geri dönüşüm davranışı yok.

Çift yönlü istemci uygulamasında geri çağırma sözleşmesi işlemini yapılandırmak için de kullanabilirsiniz OperationBehaviorAttribute . Bir geri çağırma işleminde kullanıldığında, özelliğin ReleaseInstanceMode olması None gerekir veya çalışma zamanında bir InvalidOperationException özel durum oluşturulur.

Ayrıca, hizmet oluşturucuya bir hizmet nesnesi ServiceHost.ServiceHost(Object, Uri[]) geçirilerek oluşturulursa, bu özelliğin değerinin olduğu Nonegibi kabul edildiğine dikkat etmek önemlidir.