OperationBehaviorAttribute.ReleaseInstanceMode Egenskap

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

Egenskapsvärde

Ett av ReleaseInstanceMode värdena. Standardvärdet är None.

Undantag

Exempel

Följande exempelkod visar användningen av ReleaseInstanceMode för att återanvända tjänstobjekt både före och efter ett anrop.

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

Kommentarer

Använd egenskapen ReleaseInstanceMode för att ange när Windows Communication Foundation (WCF) återvinner ett tjänstobjekt under körningen av en metod. Standardbeteendet är att återanvända ett tjänstobjekt enligt InstanceContextMode värdet. Om du anger egenskapen ReleaseInstanceMode ändras standardbeteendet.

Ger ReleaseInstanceMode inga trådningsgarantier. Om du måste ha ett nytt, oförändrade objekt när tjänsten körs anger du InstanceContextMode egenskapen till PerCall.

I transaktionsscenarier ReleaseInstanceMode används egenskapen ofta för att säkerställa att gamla data som är associerade med tjänstobjektet rensas innan ett metodanrop bearbetas. Du kan också se till att tjänstobjekt som är associerade med transaktioner återanvänds när transaktionen har slutförts genom att ange ReleaseServiceInstanceOnTransactionComplete egenskapen till true.

Du kan välja följande beteenden:

• Återanvänd ett tjänstobjekt innan en åtgärd anropas.

• Återanvänd ett tjänstobjekt efter att en åtgärd anropats.

• Återanvänd ett tjänstobjekt både före och efter att en åtgärd anropas.

• Inget återvinningsbeteende.

Du kan också använda OperationBehaviorAttribute för att konfigurera en återanropskontraktsåtgärd i ett duplex-klientprogram. När den ReleaseInstanceMode används vid en återanropsåtgärd måste egenskapen vara None eller så utlöses ett InvalidOperationException undantag vid körning.

Dessutom är det viktigt att inse att om tjänsten skapas genom att skicka ett tjänstobjekt till ServiceHost.ServiceHost(Object, Uri[]) konstruktorn behandlas värdet för den här egenskapen som om det vore None.