OperationBehaviorAttribute.ReleaseInstanceMode Propriété

Référence

Définition

Espace de noms:: System.ServiceModel

Assembly:: System.ServiceModel.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit une valeur qui indique quand recycler l'objet de service au cours d'un appel d'opération.

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é

ReleaseInstanceMode

Une des valeurs de l'objet ReleaseInstanceMode. La valeur par défaut est None.

Exceptions

ArgumentOutOfRangeException

La valeur ne fait pas partie des valeurs ReleaseInstanceMode.

Exemples

Le code d'exemple suivant illustre l'utilisation de ReleaseInstanceMode pour recycler des objets de service 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. Par défaut, l'objet de service est recyclé en fonction de la valeur InstanceContextMode. La configuration de la propriété ReleaseInstanceMode modifie ce comportement par défaut.

Le ReleaseInstanceMode n'offre aucune garantie de threading. Si vous devez avoir un objet nouveau, non modifié, lors de l'exécution du service, affectez la valeur InstanceContextMode à la propriété 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. 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.

Vous avez le choix entre les comportements suivants :

Recycler un objet de service avant l'appel d'une opération.
Recycler un objet de service après l'appel d'une opération.
Recycler un objet de service avant et après l'appel d'une opération.
Pas de comportement de recyclage.

Vous pouvez également utiliser OperationBehaviorAttribute pour configurer une opération de contrat de rappel dans une application cliente duplex. 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.

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.

S’applique à

Partager via