ContractHandle 클래스

정의

네임스페이스:

System.AddIn.Pipeline

어셈블리:

System.AddIn.dll

추가 기능의 수명을 제어하는 메서드를 제공합니다.

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, 즉, 특정 계약을 멤버를 구현 해야 합니다.

생성자

ContractHandle(IContract)

ContractHandle 클래스의 새 인스턴스를 초기화합니다.

속성

Contract

파이프라인에서 사용되는 계약을 가져옵니다.

메서드

AppDomainOwner(AppDomain)	애플리케이션 도메인이 생성되었을 때 추가 기능 쪽 어댑터의 인스턴스를 가져옵니다.
ContractOwnsAppDomain(IContract, AppDomain)	지정된 계약에서 애플리케이션 도메인을 소유하는지 확인합니다.
Dispose()	입력 값에 관계없이 계약의 수명 토큰을 해지합니다.
Dispose(Boolean)	입력 값에 관계없이 계약의 수명 토큰을 해지하고, 선택적으로 관리되는 리소스를 해제합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
Finalize()	ContractHandle 인스턴스와 연결된 리소스를 해제합니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)