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 设计为在合同到视图适配器中使用，以帮助管道开发人员管理正在改编的协定的生存期。 通常，此类的实例在适配器类的构造过程中实例化，并存储在适配器的实例字段中。 当适配器类进行垃圾回收时， ContractHandle 还将收集 对象，并且 ContractHandle 对象将撤销协定上的生存期令牌。

建议视图到协定适配器继承自 ContractBase 类。 然后，可以对 的成员 IContract使用默认实现，这意味着只需实现特定协定的成员。

构造函数

属性

方法

适用于