OperationBehaviorAttribute.ReleaseInstanceMode Propriété

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

Valeur de propriété

Une des ReleaseInstanceMode valeurs. La valeur par défaut est None.

Exceptions

Exemples

L’exemple de code suivant montre l’utilisation d’objets de ReleaseInstanceMode service à la fois avant et après un appel.

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

Remarques

Utilisez la ReleaseInstanceMode propriété pour spécifier quand Windows Communication Foundation (WCF) recycle un objet de service au cours de l’exécution d’une méthode. Le comportement par défaut consiste à recycler un objet de service en fonction de la InstanceContextMode valeur. La définition de la ReleaseInstanceMode propriété change ce comportement par défaut.

Le ReleaseInstanceMode thread n’est pas garanti. Si vous devez avoir un nouvel objet non modifié lorsque votre service s’exécute, définissez la propriété PerCallsur InstanceContextMode .

Dans les scénarios de transaction, la ReleaseInstanceMode propriété est souvent utilisée pour s’assurer que les anciennes données associées à l’objet de service sont nettoyées avant de traiter un appel de méthode. Vous pouvez également vous assurer que les objets de service associés aux transactions sont recyclés une fois la transaction terminée avec succès en définissant la ReleaseServiceInstanceOnTransactionComplete propriété truesur .

Vous pouvez choisir les comportements suivants :

• Recyclez un objet de service avant qu’une opération soit appelée.

• Recyclez un objet de service après l’appel d’une opération.

• Recyclez un objet de service avant et après l’appel d’une opération.

• Aucun comportement de recyclage.

Vous pouvez également utiliser OperationBehaviorAttribute pour configurer une opération de contrat de rappel dans une application cliente duplex. Lorsqu’elle est utilisée sur une opération de rappel, la ReleaseInstanceMode propriété doit être None ou une InvalidOperationException exception est levée au moment de l’exécution.

En outre, il est important de se rendre compte que si le service est créé en passant un objet de service au ServiceHost.ServiceHost(Object, Uri[]) constructeur, la valeur de cette propriété est traitée comme si elle était None.