OperationBehaviorAttribute.ReleaseInstanceMode Propriété

Définition

Obtient ou définit une valeur qui indique quand recycler l'objet de service au cours d'un appel d'opération.Gets or sets a value that indicates when in the course of an operation invocation to recycle the service object.

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 valeurs de ReleaseInstanceMode.One of the ReleaseInstanceMode values. La valeur par défaut est None.The default is None.

Exceptions

La valeur ne fait pas partie des valeurs ReleaseInstanceMode.The value is not one of the ReleaseInstanceMode values.

Exemples

Le code d'exemple suivant illustre l'utilisation de ReleaseInstanceMode pour recycler des objets de service avant et après un appel.The following example code shows the use of ReleaseInstanceMode to recycle service objects both before and after a call.

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.Use the ReleaseInstanceMode property to specify when Windows Communication Foundation (WCF) recycles a service object in the course of executing a method. Par défaut, l'objet de service est recyclé en fonction de la valeur InstanceContextMode.The default behavior is to recycle a service object according to the InstanceContextMode value. La configuration de la propriété ReleaseInstanceMode modifie ce comportement par défaut.Setting the ReleaseInstanceMode property changes that default behavior.

Le ReleaseInstanceMode n'offre aucune garantie de threading.The ReleaseInstanceMode makes no threading guarantees. Si vous devez avoir un objet nouveau, non modifié, lors de l'exécution du service, affectez la valeur InstanceContextMode à la propriété PerCall.If you must have a new, unmodified object when your service runs, set the InstanceContextMode property to PerCall.

Dans les scénarios de transaction, la propriété ReleaseInstanceMode est souvent utilisée pour s’assurer que les anciennes données associées à l’objet de service sont nettoyées avant le traitement d’un appel de méthode.In transaction scenarios, the ReleaseInstanceMode property is often used to ensure that old data associated with the service object is cleaned up prior to processing a method call. Vous pouvez également vous assurer que les objets de service associés aux transactions sont recyclés après l'exécution de la transaction en affectant la valeur ReleaseServiceInstanceOnTransactionComplete à la propriété true.You can also ensure that service objects associated with transactions are recycled after the transaction successfully completes by setting the ReleaseServiceInstanceOnTransactionComplete property to true.

Vous avez le choix entre les comportements suivants :You can choose the following behaviors:

  • Recycler un objet de service avant l'appel d'une opération.Recycle a service object before an operation is called.

  • Recycler un objet de service après l'appel d'une opération.Recycle a service object after an operation is called.

  • Recycler un objet de service avant et après l'appel d'une opération.Recycle a service object both before and after an operation is called.

  • Pas de comportement de recyclage.No recycling behavior.

Vous pouvez également utiliser OperationBehaviorAttribute pour configurer une opération de contrat de rappel dans une application cliente duplex.You can also use OperationBehaviorAttribute to configure a callback contract operation in a duplex client application. Lorsque vous l'utilisez dans le cadre d'une opération de rappel, la propriété ReleaseInstanceMode doit avoir la valeur None, sinon une exception InvalidOperationException est levée au moment de l'exécution.When used on a callback operation, the ReleaseInstanceMode property must be None or an InvalidOperationException exception is thrown at runtime.

De plus, il est important de garder à l'esprit que si le service est créé en passant un objet de service au constructeur ServiceHost.ServiceHost(Object, Uri[]), la valeur de cette propriété est traitée comme si elle était None.In addition, it is important to realize that if the service is created by passing a service object to the ServiceHost.ServiceHost(Object, Uri[]) constructor, the value of this property is treated as if it were None.

S’applique à