This documentation is archived and is not being maintained.

ReleaseInstanceMode Enumeration

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

Namespace:  System.ServiceModel
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public enum ReleaseInstanceMode

Member nameDescription
NoneRecycles the object according to the InstanceContextMode value.
BeforeCallRecycles the object prior to calling the operation.
AfterCallRecycles the object subsequent to the completion of the operation.
BeforeAndAfterCallRecycles the object prior to calling the operation and subsequent to the completion of the operation.

Use the ReleaseInstanceMode with the ReleaseInstanceMode property to inform 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.

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);
  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;

    Console.WriteLine("Object {0} has been destroyed.", id);
    Console.WriteLine("For session {0}", session);

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.