IInstanceProvider Interfaccia

Definizione

Dichiara metodi che specificano un oggetto servizio o lo riciclano per un servizio di Windows Communication Foundation (WCF).Declares methods that provide a service object or recycle a service object for a Windows Communication Foundation (WCF) service.

public interface class IInstanceProvider
public interface IInstanceProvider
type IInstanceProvider = interface
Public Interface IInstanceProvider

Esempi

Nell'esempio di codice seguente viene illustrato come implementare un oggetto IInstanceProvider che fornisca un comportamento "singleton", restituisca sempre la stessa istanza del servizio e non la ricicli.The following code example shows how to implement IInstanceProvider that provides "singleton" behavior; it always returns the same service instance and does not recycle it.

public class ObjectProviderBehavior : IInstanceProvider
{

  string message;
  SampleService service = null;

  public ObjectProviderBehavior(string msg)
  {
    Console.WriteLine("The non-default constructor has been called.");
    this.message = msg;
    this.service = new SampleService("Singleton sample service.");
  }

  #region IInstanceProvider Members

  public object GetInstance(InstanceContext instanceContext, System.ServiceModel.Channels.Message message)
  {
    Console.WriteLine("GetInstance is called:");
    return this.service;
  }

  public object GetInstance(InstanceContext instanceContext)
  {
    Console.WriteLine("GetInstance is called:");
    return this.service;
  }

  public void ReleaseInstance(InstanceContext instanceContext, object instance)
  {
    Console.WriteLine("ReleaseInstance is called. The SingletonBehaviorAttribute never releases.");
  }

  #endregion
}
Public Class ObjectProviderBehavior
    Implements IInstanceProvider

  Private message As String
  Private service As SampleService = Nothing

  Public Sub New(ByVal msg As String)
    Console.WriteLine("The non-default constructor has been called.")
    Me.message = msg
    Me.service = New SampleService("Singleton sample service.")
  End Sub

  #Region "IInstanceProvider Members"

  Public Function GetInstance(ByVal instanceContext As InstanceContext, ByVal message As System.ServiceModel.Channels.Message) As Object Implements IInstanceProvider.GetInstance
    Console.WriteLine("GetInstance is called:")
    Return Me.service
  End Function

  Public Function GetInstance(ByVal instanceContext As InstanceContext) As Object Implements IInstanceProvider.GetInstance
    Console.WriteLine("GetInstance is called:")
    Return Me.service
  End Function

  Public Sub ReleaseInstance(ByVal instanceContext As InstanceContext, ByVal instance As Object) Implements IInstanceProvider.ReleaseInstance
    Console.WriteLine("ReleaseInstance is called. The SingletonBehaviorAttribute never releases.")
  End Sub

  #End Region
End Class

Nell'esempio di codice seguente viene illustrato come implementare un attributo personalizzato che implementi IContractBehavior al fine di inserire il provider di istanze del servizio personalizzato.The following code example shows how to implement a custom attribute that implements IContractBehavior to insert the custom service instance provider. Implementa inoltre IContractBehaviorAttribute che ne associa l'utilizzo a un contratto specifico.It also implements IContractBehaviorAttribute, which binds its use to a specific contract.

public class SingletonBehaviorAttribute : Attribute, IContractBehaviorAttribute, IContractBehavior
{

  #region IContractBehaviorAttribute Members

  public Type TargetContract
  {
    get { return typeof(ISampleService); }
  }

  #endregion

  #region IContractBehavior Members

  public void AddBindingParameters(ContractDescription description, ServiceEndpoint endpoint, System.ServiceModel.Channels.BindingParameterCollection parameters)
  {
    return;
  }

  public void ApplyClientBehavior(ContractDescription description, ServiceEndpoint endpoint, ClientRuntime clientRuntime)
  {
    return;
  }

  public void ApplyDispatchBehavior(ContractDescription description, ServiceEndpoint endpoint, DispatchRuntime dispatch)
  {
    dispatch.InstanceProvider = new ObjectProviderBehavior("Custom ObjectProviderBehavior constructor.");
  }

  public void Validate(ContractDescription description, ServiceEndpoint endpoint)
  {
    return;
  }

  #endregion
}
Public Class SingletonBehaviorAttribute
    Inherits Attribute
    Implements IContractBehaviorAttribute, IContractBehavior

  #Region "IContractBehaviorAttribute Members"

  Public ReadOnly Property TargetContract() As Type Implements IContractBehaviorAttribute.TargetContract
    Get
        Return GetType(ISampleService)
    End Get
  End Property

  #End Region

  #Region "IContractBehavior Members"

  Public Sub AddBindingParameters(ByVal description As ContractDescription, ByVal endpoint As ServiceEndpoint, ByVal parameters As System.ServiceModel.Channels.BindingParameterCollection) Implements IContractBehavior.AddBindingParameters
    Return
  End Sub

  Public Sub ApplyClientBehavior(ByVal description As ContractDescription, ByVal endpoint As ServiceEndpoint, ByVal clientRuntime As ClientRuntime) Implements IContractBehavior.ApplyClientBehavior
    Return
  End Sub

  Public Sub ApplyDispatchBehavior(ByVal description As ContractDescription, ByVal endpoint As ServiceEndpoint, ByVal dispatch As DispatchRuntime) Implements IContractBehavior.ApplyDispatchBehavior
    dispatch.InstanceProvider = New ObjectProviderBehavior("Custom ObjectProviderBehavior constructor.")
  End Sub

  Public Sub Validate(ByVal description As ContractDescription, ByVal endpoint As ServiceEndpoint) Implements IContractBehavior.Validate
    Return
  End Sub

  #End Region
End Class

Commenti

Implementare l'interfaccia IInstanceProvider per controllare la creazione e il riciclaggio di oggetti servizio quando un oggetto InstanceContext ne richiede o ne elimina uno.Implement the IInstanceProvider interface to control the creation and recycling of service objects when one is requested or disposed by an InstanceContext object.

Una volta implementata l'interfaccia IInstanceProvider, è necessario assegnare l'oggetto provider di istanze personalizzato alla proprietà InstanceProvider utilizzando un comportamento dell'endpoint (un oggetto IEndpointBehavior) o un comportamento del contratto (un oggetto IContractBehavior).Once the IInstanceProvider interface is implemented, you must assign your custom instance provider object to the InstanceProvider property using either an endpoint behavior (a IEndpointBehavior object) or a contract behavior (a IContractBehavior object).

Se il meccanismo di inserimento è un comportamento dell'endpoint, è anche possibile implementare un oggetto BehaviorExtensionElement in grado di inserire il comportamento personalizzato utilizzando un file di configurazione.If the insertion mechanism is an endpoint behavior you can also implement a BehaviorExtensionElement object that can insert your custom behavior using a configuration file. Se il meccanismo di inserimento è un comportamento del contratto, è possibile inserire il comportamento a livello di programmazione prima dell'apertura dell'host del servizio o implementare un attributo personalizzato.If the insertion mechanism is a contract behavior, you can insert the behavior programmatically prior to the opening of the service host or you can implement a custom attribute. Per un'esempio dell'approccio relativo al comportamento del contratto, vedere la sezione relativa agli esempi.(For an example of the contract behavior approach, see the Example section.)

L'oggetto IInstanceProvider dispone di due metodi: GetInstance e ReleaseInstance.IInstanceProvider has two methods, GetInstance and ReleaseInstance. Questi metodi vengono in genere implementati per creare oggetti servizio usando un costruttore senza parametri o per inizializzare o eliminare uno stato correlato alla durata dell'oggetto.These methods are typically implemented to create service objects using a non-parameterless constructor or to initialize or dispose of some state related to the lifetime of the object. Il pooling degli oggetti servizio è un esempio di funzionalità IInstanceProvider personalizzata.Service object pooling is one example of custom IInstanceProvider functionality.

InstanceContext in genere richiama GetInstance quando l'oggetto InstanceContext viene creato inizialmente e chiama il metodo ReleaseInstance quando InstanceContext viene chiuso.Typically, the InstanceContext invokes the GetInstance when the InstanceContext is first created and invokes the ReleaseInstance method when the InstanceContext is closed.

Sono disponibili due modalità per fare in modo che un oggetto InstanceContext rilasci un oggetto servizio prima che InstanceContext venga chiuso.There are two ways to cause an InstanceContext object to release a service object before the InstanceContext is closed. Il primo metodo consiste nell'impostare ReleaseInstanceMode suAfterCall o su BeforeAndAfterCall.The first method is to set the ReleaseInstanceMode to AfterCall or BeforeAndAfterCall. La seconda possibilità consiste nel chiamare il metodo ReleaseServiceInstance.The second method is to call the ReleaseServiceInstance method. Se si procede in questo modo, InstanceContext chiama il metodo ReleaseInstance sul provider di istanze del dispatcher.If this is done, the InstanceContext calls the ReleaseInstance method on the dispatcher's instance provider. Se un nuovo messaggio arriva dopo il rilascio dell'istanza, WCF crea una nuova istanza utilizzando il GetInstance metodo.If a new message arrives after the instance has been released, WCF creates a new instance using the GetInstance method.

Nota

Se l'oggetto InstanceContextMode del servizio è Single, il sistema non chiama i metodi GetInstance e ReleaseInstance anche se l'utente non ha fornito un oggetto servizio noto, a meno che l'utente non chiami direttamente ReleaseServiceInstance e quindi GetServiceInstance.If the InstanceContextMode of the service is Single, the system does not call the GetInstance or ReleaseInstance methods even when the user did not provide a well-known service object unless the user directly calls ReleaseServiceInstance and then calls GetServiceInstance.

Metodi

GetInstance(InstanceContext)

Restituisce un oggetto servizio dato l'oggetto InstanceContext specificato.Returns a service object given the specified InstanceContext object.

GetInstance(InstanceContext, Message)

Restituisce un oggetto servizio dato l'oggetto InstanceContext specificato.Returns a service object given the specified InstanceContext object.

ReleaseInstance(InstanceContext, Object)

Chiamato quando un oggetto InstanceContext ricicla un oggetto servizio.Called when an InstanceContext object recycles a service object.

Si applica a