ContractHandle クラス

定義

public ref class ContractHandle : IDisposable

public class ContractHandle : IDisposable

type ContractHandle = class
    interface IDisposable

Public Class ContractHandle
Implements IDisposable

継承

Object

ContractHandle

実装

IDisposable

例

次の例は、パイプラインのアドイン側のコントラクトからビューへのアダプターで有効期間トークン ハンドルを設定する方法を示しています。

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

注釈

アドイン モデルは、アプリケーション ドメイン間およびプロセス間でアドインが通信する機能を提供するため、ガベージ コレクターを利用してそれらを再利用することはできません。 このクラスは、コントラクトへの有効期間トークンを取得することによって、アドインの参照カウント メカニズムを提供します。

オブジェクトが ContractHandle 構築されると、コンストラクターに渡されるコントラクトで メソッドが呼び出 AcquireLifetimeToken されます。 オブジェクトが ContractHandle 破棄または最終処理されると、コントラクトで メソッドが RevokeLifetimeToken 呼び出され、コントラクトの保留が削除されます。

アダプターはコントラクトを実装します。 クラスは ContractHandle 、パイプライン開発者が調整中のコントラクトの有効期間を管理するのに役立つ、コントラクトからビューへのアダプターで使用するように設計されています。 通常、このクラスのインスタンスはアダプター クラスの構築中にインスタンス化され、アダプターのインスタンス フィールドに格納されます。 アダプター クラスがガベージ コレクションされると、オブジェクトも収集され、ContractHandleContractHandleオブジェクトはコントラクトの有効期間トークンを取り消します。

ビューからコントラクトへのアダプターは、 クラスから ContractBase 継承することをお勧めします。 その後、 のメンバーに既定の IContract実装を使用できます。つまり、特定のコントラクトのメンバーのみを実装する必要があります。

コンストラクター

プロパティ

メソッド

適用対象