OperationBehaviorAttribute.ReleaseInstanceMode Eigenschaft

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

Eigenschaftswert

Einer der ReleaseInstanceMode Werte. Der Standardwert lautet None.

Ausnahmen

Beispiele

Im folgenden Beispielcode wird die Verwendung von ReleaseInstanceMode Dienstobjekten vor und nach einem Aufruf veranschaulicht.

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

Hinweise

Verwenden Sie die ReleaseInstanceMode Eigenschaft, um anzugeben, wann Windows Communication Foundation (WCF) ein Dienstobjekt im Verlauf der Ausführung einer Methode wiederverwendet. Das Standardverhalten besteht darin, ein Dienstobjekt entsprechend dem InstanceContextMode Wert wiederzuverwenden. Durch Festlegen der ReleaseInstanceMode Eigenschaft wird das Standardverhalten geändert.

Dies ReleaseInstanceMode garantiert keine Threadinggarantien. Wenn Beim Ausführen des Diensts ein neues, nicht geändertes Objekt vorhanden sein muss, legen Sie die InstanceContextMode Eigenschaft auf PerCall.

In Transaktionsszenarien wird die ReleaseInstanceMode Eigenschaft häufig verwendet, um sicherzustellen, dass alte Daten, die dem Dienstobjekt zugeordnet sind, vor der Verarbeitung eines Methodenaufrufs bereinigt werden. Sie können auch sicherstellen, dass Dienstobjekte, die Transaktionen zugeordnet sind, wiederverwendet werden, nachdem die Transaktion erfolgreich abgeschlossen wurde, indem Sie die ReleaseServiceInstanceOnTransactionComplete Eigenschaft auf truefestlegen.

Sie können die folgenden Verhaltensweisen auswählen:

• Wiederverwenden eines Dienstobjekts, bevor ein Vorgang aufgerufen wird.

• Wiederverwenden eines Dienstobjekts nach dem Aufrufen eines Vorgangs.

• Wiederverwenden eines Dienstobjekts vor und nach dem Aufrufen eines Vorgangs.

• Kein Recyclingverhalten.

Sie können auch OperationBehaviorAttribute einen Rückrufvertragsvorgang in einer Duplexclientanwendung konfigurieren. Wenn sie für einen Rückrufvorgang verwendet wird, muss die ReleaseInstanceMode Eigenschaft sein None oder eine InvalidOperationException Ausnahme wird zur Laufzeit ausgelöst.

Darüber hinaus ist es wichtig zu erkennen, dass der Wert dieser Eigenschaft behandelt Nonewird, wenn der Dienst durch Übergeben eines Dienstobjekts an den ServiceHost.ServiceHost(Object, Uri[]) Konstruktor erstellt wird.