OperationBehaviorAttribute.ReleaseInstanceMode Proprietà

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

Valore della proprietà

Uno dei ReleaseInstanceMode valori. Il valore predefinito è None.

Eccezioni

Esempio

Il codice di esempio seguente illustra l'uso di ReleaseInstanceMode per riciclare gli oggetti servizio sia prima che dopo una chiamata.

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

Commenti

Utilizzare la ReleaseInstanceMode proprietà per specificare quando Windows Communication Foundation (WCF) ricicla un oggetto servizio durante l'esecuzione di un metodo. Il comportamento predefinito consiste nel riciclare un oggetto servizio in base al InstanceContextMode valore . L'impostazione della proprietà cambia il ReleaseInstanceMode comportamento predefinito.

non ReleaseInstanceMode garantisce il threading. Se è necessario disporre di un nuovo oggetto non modificato durante l'esecuzione del servizio, impostare la InstanceContextMode proprietà su PerCall.

Negli scenari di transazione, la ReleaseInstanceMode proprietà viene spesso usata per garantire che i dati obsoleti associati all'oggetto servizio vengano puliti prima dell'elaborazione di una chiamata al metodo. È anche possibile assicurarsi che gli oggetti servizio associati alle transazioni vengano riciclati al termine della transazione impostando la ReleaseServiceInstanceOnTransactionComplete proprietà su true.

È possibile scegliere i comportamenti seguenti:

• Riciclare un oggetto servizio prima che venga chiamata un'operazione.

• Riciclare un oggetto servizio dopo la chiamata di un'operazione.

• Riciclare un oggetto servizio prima e dopo la chiamata di un'operazione.

• Nessun comportamento di riciclo.

È anche possibile usare OperationBehaviorAttribute per configurare un'operazione del contratto di callback in un'applicazione client duplex. Se utilizzata in un'operazione di callback, la ReleaseInstanceMode proprietà deve essere None o viene generata un'eccezione InvalidOperationException in fase di esecuzione.

Inoltre, è importante tenere presente che se il servizio viene creato passando un oggetto servizio al ServiceHost.ServiceHost(Object, Uri[]) costruttore, il valore di questa proprietà viene considerato come se fosse None.