AddInToken.Activate 메서드

참조

정의

네임스페이스:: System.AddIn.Hosting

어셈블리:: System.AddIn.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

추가 기능을 활성화합니다.

오버로드

Activate<T>(AddInEnvironment)	특정 추가 기능을 다른 추가 기능의 환경에서 활성화합니다.
Activate<T>(AddInSecurityLevel)	새 애플리케이션 도메인에서 지정된 신뢰 수준으로 추가 기능을 활성화합니다.
Activate<T>(AppDomain)	기존 애플리케이션 도메인에서 추가 기능을 활성화합니다.
Activate<T>(PermissionSet)	새 애플리케이션 도메인에서 지정된 권한 집합으로 추가 기능을 활성화합니다.
Activate<T>(AddInProcess, AddInSecurityLevel)	새 애플리케이션 도메인의 외부 프로세스에서 지정된 신뢰 수준으로 추가 기능을 활성화합니다.
Activate<T>(AddInProcess, PermissionSet)	새 애플리케이션 도메인의 외부 프로세스에서 지정된 권한 집합으로 추가 기능을 활성화합니다.
Activate<T>(AddInSecurityLevel, String)	새 애플리케이션 도메인에서 지정된 이름 및 신뢰 수준으로 추가 기능을 활성화합니다.

Activate<T>(AddInEnvironment)

특정 추가 기능을 다른 추가 기능의 환경에서 활성화합니다.

public:
generic <typename T>
 T Activate(System::AddIn::Hosting::AddInEnvironment ^ environment);

public T Activate<T> (System.AddIn.Hosting.AddInEnvironment environment);

member this.Activate : System.AddIn.Hosting.AddInEnvironment -> 'T

Public Function Activate(Of T) (environment As AddInEnvironment) As T

형식 매개 변수

T

추가 기능의 호스트 뷰를 나타내는 인터페이스 또는 추상 기본 형식입니다.

매개 변수

environment: AddInEnvironment

원래 추가 기능을 포함하는 애플리케이션 도메인 및 프로세스입니다.

반환

추가 기능의 호스트 뷰입니다.

예제

다음 예제에서는 하나의 추가 기능에 지정된 된 보안 수준 사용 하 여 자동으로 생성 된 애플리케이션 도메인에서 활성화합니다. 다음 두 번째 추가에 동일한 애플리케이션 도메인 및 프로세스를 처음 사용 하 여 첫 번째에 있는 추가 기능이 활성화 AddInEnvironment 개체입니다.

// Get the AddInController of a
// currently actived add-in (CalcAddIn).
AddInController aiController = AddInController.GetAddInController(CalcAddIn);

// Select another token.
AddInToken selectedToken2 = ChooseAddIn(tokens);

// Activate a second add-in, CalcAddIn2, in the same
// appliation domain and process as the first add-in by passing
// the first add-in's AddInEnvironment object to the Activate method.
AddInEnvironment aiEnvironment = aiController.AddInEnvironment;
Calculator CalcAddIn2 =
    selectedToken2.Activate<Calculator>(aiEnvironment);

// Get the AddInController for the second add-in to compare environments.
AddInController aiController2 = AddInController.GetAddInController(CalcAddIn2);
Console.WriteLine("Add-ins in same application domain: {0}", aiController.AppDomain.Equals(aiController2.AppDomain));
Console.WriteLine("Add-ins in same process: {0}", aiEnvironment.Process.Equals(aiController2.AddInEnvironment.Process));

' Get the AddInController of a 
' currently activated add-in (CalcAddIn).
Dim aiController As AddInController = AddInController.GetAddInController(CalcAddIn)

' Select another token.
Dim selectedToken2 As AddInToken = ChooseAddIn(tokens)

' Activate a second add-in, CalcAddIn2, in the same
' appliation domain and process as the first add-in by passing
' the first add-in's AddInEnvironment object to the Activate method.

Dim aiEnvironment As AddInEnvironment = aiController.AddInEnvironment
Dim CalcAddIn2 As Calculator = _
    selectedToken2.Activate(Of Calculator)(aiEnvironment)

' Get the AddInController for the second add-in to compare environments.
Dim aiController2 As AddInController = AddInController.GetAddInController(CalcAddIn2)

Console.WriteLine("Add-ins in same application domain: {0}", _
    aiController.AppDomain.Equals(aiController2.AppDomain))
Console.WriteLine("Add-ins in same process: {0}", _
    aiEnvironment.Process.Equals(aiController2.AddInEnvironment.Process))

설명

이 메서드 오버 로드는 추가 기능으로 동일한 애플리케이션 도메인 및 프로세스에 있는 추가 기능의 활성화 environment 가져온 합니다.

추가 정보

추가 기능 및 확장성

적용 대상

Activate<T>(AddInSecurityLevel)

새 애플리케이션 도메인에서 지정된 신뢰 수준으로 추가 기능을 활성화합니다.

public:
generic <typename T>
 T Activate(System::AddIn::Hosting::AddInSecurityLevel trustLevel);

public T Activate<T> (System.AddIn.Hosting.AddInSecurityLevel trustLevel);

member this.Activate : System.AddIn.Hosting.AddInSecurityLevel -> 'T

Public Function Activate(Of T) (trustLevel As AddInSecurityLevel) As T

형식 매개 변수

T

추가 기능의 호스트 뷰를 나타내는 인터페이스 또는 추상 기본 형식입니다.

매개 변수

trustLevel: AddInSecurityLevel

신뢰 수준을 지정하는 열거형 값 중 하나입니다.

반환

추가 기능의 호스트 뷰입니다.

예제

다음 예제에서는의 추가 기능을 활성화 하는 방법 지정된 된 보안 수준 사용 하 여 자동으로 생성 된 애플리케이션 도메인에서 선택한 토큰으로 식별 합니다.

//Ask the user which add-in they would like to use.
AddInToken selectedToken = ChooseAddIn(tokens);

//Activate the selected AddInToken in a new
//application domain with the Internet trust level.
Calculator CalcAddIn = selectedToken.Activate<Calculator>(AddInSecurityLevel.Internet);

//Run the add-in using a custom method.
RunCalculator(CalcAddIn);

'Ask the user which add-in they would like to use.
Dim selectedToken As AddInToken = ChooseAddIn(tokens)
'Activate the selected AddInToken in a new
'application domain with the Internet trust level.
Dim CalcAddIn As Calculator = selectedToken.Activate(Of Calculator)(AddInSecurityLevel.Internet)
'Run the add-in using a custom method.
RunCalculator(CalcAddIn)

설명

이 메서드 오버 로드는 추가 기능에 자동으로 생성 된 애플리케이션 도메인에 로드합니다. 사용 하 여 새 애플리케이션 도메인의 이름을 지정 하려는 경우는 Activate<T>(AddInSecurityLevel, String) 오버 로드 합니다.

이 메서드는 추가 기능 어셈블리의 위치를 애플리케이션 도메인에 대 한 기본 디렉터리를 설정 합니다. 또한 구성 파일 [addinassemblyname].dll.config 및 경우를 찾습니다 발견, 새 애플리케이션 도메인의 구성 파일로 설정 합니다.

추가 정보

추가 기능 및 확장성

적용 대상

Activate<T>(AppDomain)

기존 애플리케이션 도메인에서 추가 기능을 활성화합니다.

public:
generic <typename T>
 T Activate(AppDomain ^ target);

public T Activate<T> (AppDomain target);

member this.Activate : AppDomain -> 'T

Public Function Activate(Of T) (target As AppDomain) As T

형식 매개 변수

T

추가 기능의 호스트 뷰를 나타내는 인터페이스 또는 추상 기본 형식입니다.

매개 변수

target: AppDomain

추가 기능을 활성화해야 하는 애플리케이션 도메인입니다.

반환

추가 기능의 호스트 뷰입니다.

예외

SecurityException

Full Trust 권한이 필요합니다. 호출 체인에 있는 호출자에게 충분한 사용 권한이 없는 경우

예제

다음 예제에서는 다른 추가 기능에서 사용 되는 애플리케이션 도메인에서 추가 기능을 활성화 합니다. 첫 번째 추가 기능에 대 한 코드에 제공 되는 AddInToken 클래스입니다.

// Get the application domain
// of an existing add-in (CalcAddIn).
AddInController aiCtrl = AddInController.GetAddInController(CalcAddIn);
AppDomain AddInAppDom = aiCtrl.AppDomain;

// Activate another add-in in the same application domain.
Calculator CalcAddIn3 =
    selectedToken2.Activate<Calculator>(AddInAppDom);

// Show that CalcAddIn3 was loaded
// into CalcAddIn's application domain.
AddInController aic = AddInController.GetAddInController(CalcAddIn3);
Console.WriteLine("Add-in loaded into existing application domain: {0}",
    aic.AppDomain.Equals(AddInAppDom));

' Get the application domain
' of an existing add-in (CalcAddIn).

Dim aiCtrl As AddInController = AddInController.GetAddInController(CalcAddIn)
Dim AddInAppDom As AppDomain = aiCtrl.AppDomain

' Activate another add-in in the same appliation domain.
Dim CalcAddIn3 As Calculator = selectedToken2.Activate(Of Calculator)(AddInAppDom)

' Show that the CalcAddIn3 was loaded
' into CalcCaddIn's application domain.
Dim aic As AddInController = AddInController.GetAddInController(CalcAddIn3)
Console.WriteLine("Add-in loaded into existing application domain: {0}", _
 aic.AppDomain.Equals(AddInAppDom))

설명

자동으로 생성 된 애플리케이션 도메인에서 추가 기능을 활성화 하려면 사용 합니다 Activate<T>(AddInSecurityLevel) 지정된 된 보안 수준 사용 하 여 새 애플리케이션 도메인을 생성 하는 오버 로드 또는 Activate<T>(AddInSecurityLevel, String) 애플리케이션 도메인의 친숙 한 이름을 포함 하는 오버 로드 합니다.

적용 대상

Activate<T>(PermissionSet)

새 애플리케이션 도메인에서 지정된 권한 집합으로 추가 기능을 활성화합니다.

public:
generic <typename T>
 T Activate(System::Security::PermissionSet ^ permissions);

public T Activate<T> (System.Security.PermissionSet permissions);

member this.Activate : System.Security.PermissionSet -> 'T

Public Function Activate(Of T) (permissions As PermissionSet) As T

형식 매개 변수

T

추가 기능의 호스트 뷰를 나타내는 인터페이스 또는 추상 기본 형식입니다.

매개 변수

permissions: PermissionSet

추가 기능에 대해 부여된 권한입니다.

반환

추가 기능의 호스트 뷰입니다.

예외

ArgumentNullException

permissions은 null입니다.

설명

이 메서드 오버 로드는 추가 기능에 자동으로 생성 된 애플리케이션 도메인에 로드합니다. 추가 기능 어셈블리의 위치를 애플리케이션 도메인에 대 한 기본 디렉터리를 설정 합니다. 또한 구성 파일을 찾고 [addinassemblyname].dll.config 집합 발견 하는 경우 새 애플리케이션 도메인에 대 한 구성 파일을 되도록 합니다.

적용 대상

Activate<T>(AddInProcess, AddInSecurityLevel)

새 애플리케이션 도메인의 외부 프로세스에서 지정된 신뢰 수준으로 추가 기능을 활성화합니다.

public:
generic <typename T>
 T Activate(System::AddIn::Hosting::AddInProcess ^ process, System::AddIn::Hosting::AddInSecurityLevel level);

public T Activate<T> (System.AddIn.Hosting.AddInProcess process, System.AddIn.Hosting.AddInSecurityLevel level);

member this.Activate : System.AddIn.Hosting.AddInProcess * System.AddIn.Hosting.AddInSecurityLevel -> 'T

Public Function Activate(Of T) (process As AddInProcess, level As AddInSecurityLevel) As T

형식 매개 변수

T

추가 기능의 호스트 뷰를 나타내는 인터페이스 또는 추상 기본 형식입니다.

매개 변수

process: AddInProcess

추가 기능을 활성화하는 외부 프로세스.

level: AddInSecurityLevel

신뢰 수준을 지정하는 열거형 값 중 하나입니다.

반환

추가 기능의 호스트 뷰입니다.

예제

다음 예제에서는 새 프로세스를 만들고 추가 기능을 완전 신뢰 보안 수준 사용 하 여 해당 프로세스에서 활성화 합니다.

// Create an external process.
AddInProcess pExternal = new AddInProcess();

// Activate an add-in in the external process
// with a full trust security level.
Calculator CalcAddIn4 =
    selectedToken.Activate<Calculator>(pExternal,
    AddInSecurityLevel.FullTrust);

// Show that the add-in is an external process
// by verifying that it is not in the current (host's) process.
AddInController AddinCtl = AddInController.GetAddInController(CalcAddIn4);
Console.WriteLine("Add-in in host's process: {0}",
    AddinCtl.AddInEnvironment.Process.IsCurrentProcess);

' Create an external process.
Dim pExternal As New AddInProcess()

' Activate an add-in in the external process
' with a full trust security level.
Dim CalcAddIn4 As Calculator = _
    selectedToken.Activate(Of Calculator)(pExternal, _
        AddInSecurityLevel.FullTrust)

' Show that the add-in is an external process
' by verifying that it is not in the current (host's) process.
Dim AddinCtl As AddInController = AddInController.GetAddInController(CalcAddIn4)
Console.WriteLine("Add-in in host's process: {0}", _
 AddinCtl.AddInEnvironment.Process.IsCurrentProcess)

설명

이 메서드는 추가 기능 어셈블리의 위치를 애플리케이션 도메인에 대 한 기본 디렉터리를 설정 합니다. 또한 구성 파일을 찾고 [addinassemblyname].dll.config 집합 발견 하는 경우 새 애플리케이션 도메인에 대 한 구성 파일을 되도록 합니다.

적용 대상

Activate<T>(AddInProcess, PermissionSet)

새 애플리케이션 도메인의 외부 프로세스에서 지정된 권한 집합으로 추가 기능을 활성화합니다.

public:
generic <typename T>
 T Activate(System::AddIn::Hosting::AddInProcess ^ process, System::Security::PermissionSet ^ permissionSet);

public T Activate<T> (System.AddIn.Hosting.AddInProcess process, System.Security.PermissionSet permissionSet);

member this.Activate : System.AddIn.Hosting.AddInProcess * System.Security.PermissionSet -> 'T

Public Function Activate(Of T) (process As AddInProcess, permissionSet As PermissionSet) As T

형식 매개 변수

T

추가 기능의 호스트 뷰를 나타내는 인터페이스 또는 추상 기본 형식입니다.

매개 변수

process: AddInProcess

추가 기능을 활성화하는 외부 프로세스.

permissionSet: PermissionSet

추가 기능에 대해 부여된 필요한 권한 집합입니다.

반환

추가 기능의 호스트 뷰입니다.

설명

적용 대상

Activate<T>(AddInSecurityLevel, String)

새 애플리케이션 도메인에서 지정된 이름 및 신뢰 수준으로 추가 기능을 활성화합니다.

public:
generic <typename T>
 T Activate(System::AddIn::Hosting::AddInSecurityLevel trustLevel, System::String ^ appDomainName);

public T Activate<T> (System.AddIn.Hosting.AddInSecurityLevel trustLevel, string appDomainName);

member this.Activate : System.AddIn.Hosting.AddInSecurityLevel * string -> 'T

Public Function Activate(Of T) (trustLevel As AddInSecurityLevel, appDomainName As String) As T

형식 매개 변수

T

추가 기능의 호스트 뷰를 나타내는 인터페이스 또는 추상 기본 형식입니다.

매개 변수

trustLevel: AddInSecurityLevel

신뢰 수준을 지정하는 열거형 값 중 하나입니다.

appDomainName: String

새 애플리케이션 도메인에 할당할 이름입니다.

반환

추가 기능의 호스트 뷰입니다.

설명

사용 하 여 애플리케이션 도메인 이름을 지정 해야 하는 경우는 Activate<T>(AddInSecurityLevel) 오버 로드 합니다.

적용 대상

AddInToken.Activate 메서드

정의

오버로드

Activate<T>(AddInEnvironment)

형식 매개 변수

매개 변수

반환

예제

설명

추가 정보

적용 대상

Activate<T>(AddInSecurityLevel)

형식 매개 변수

매개 변수

반환

예제

설명

추가 정보

적용 대상

Activate<T>(AppDomain)

형식 매개 변수

매개 변수

반환

예외

예제

설명

적용 대상

Activate<T>(PermissionSet)

형식 매개 변수

매개 변수

반환

예외

설명

적용 대상

Activate<T>(AddInProcess, AddInSecurityLevel)

형식 매개 변수

매개 변수

반환

예제

설명

적용 대상

Activate<T>(AddInProcess, PermissionSet)

형식 매개 변수

매개 변수

반환

설명

적용 대상

Activate<T>(AddInSecurityLevel, String)

형식 매개 변수

매개 변수

반환

설명

적용 대상

피드백

추가 리소스