ContractHandle Classe

Definizione

public ref class ContractHandle : IDisposable

public class ContractHandle : IDisposable

type ContractHandle = class
    interface IDisposable

Public Class ContractHandle
Implements IDisposable

Ereditarietà

Object

ContractHandle

Implementazioni

IDisposable

Esempio

Nell'esempio seguente viene illustrato come impostare l'handle di token di durata in un adattatore da contratto a visualizzazione sul lato componente aggiuntivo di una pipeline.

private CalculatorContracts.ICalc2Contract _contract;

private System.AddIn.Pipeline.ContractHandle _handle;

public CalculatorContractToViewHostAdapter(ICalc2Contract contract) {
    _contract = contract;
    _handle = new System.AddIn.Pipeline.ContractHandle(contract);
}

Private _contract As ICalc2Contract
Private _handle As ContractHandle

Public Sub New(ByVal contract As ICalc2Contract)
    _contract = contract
    _handle = New ContractHandle(contract)
End Sub

Commenti

Poiché il modello di componente aggiuntivo consente ai componenti aggiuntivi di comunicare tra domini applicazione e tra processi, non può basarsi sul Garbage Collector per recuperarli. Questa classe fornisce un meccanismo di conteggio dei riferimenti per il componente aggiuntivo ottenendo un token di durata al contratto.

Quando viene costruito un ContractHandle oggetto, chiama il AcquireLifetimeToken metodo sul contratto passato al costruttore. Quando l'oggetto ContractHandle viene eliminato o finalizzato, chiama il RevokeLifetimeToken metodo sul contratto, che rimuove il relativo blocco sul contratto.

Gli adattatori implementano il contratto. La ContractHandle classe è progettata per essere usata in un adattatore da contratto a visualizzazione per aiutare gli sviluppatori di pipeline a gestire la durata del contratto che viene adattato. In genere, un'istanza di questa classe viene creata un'istanza durante la costruzione della classe adapter e viene archiviata in un campo di istanza dell'adattatore. Quando la classe adapter viene sottoposta a Garbage Collection, l'oggetto ContractHandle verrà raccolto e l'oggetto ContractHandle revoca il token di durata nel contratto.

È consigliabile che gli adattatori da visualizzazione a contratto ereditino dalla ContractBase classe . È quindi possibile usare un'implementazione predefinita per i membri di IContract, il che significa che è necessario implementare solo i membri del contratto specifico.