Edit

Share via


ReleaseInstanceMode Enum

Definition

Specifies when the system recycles the service object in the operation invocation process.

C#
public enum ReleaseInstanceMode
Inheritance
ReleaseInstanceMode

Fields

Name Value Description
None 0

Recycles the object according to the InstanceContextMode value.

BeforeCall 1

Recycles the object prior to calling the operation.

AfterCall 2

Recycles the object subsequent to the completion of the operation.

BeforeAndAfterCall 3

Recycles the object prior to calling the operation and subsequent to the completion of the operation.

Examples

The following example code shows the use of ReleaseInstanceMode to recycle service objects both before and after a call.

C#
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);
  }
}

Remarks

Use the ReleaseInstanceMode with the ReleaseInstanceMode property to inform Windows Communication Foundation (WCF) that the current service object must be recycled at a particular point in the invocation process. The default behavior is to recycle a service object according to the InstanceContextMode value.

Applies to

Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1