AddInToken.Activate 메서드

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

형식 매개 변수

매개 변수

반품

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

예제

다음 예제에서는 지정된 보안 수준으로 자동으로 생성된 애플리케이션 도메인에서 하나의 추가 기능을 활성화합니다. 그런 다음, 동일한 애플리케이션 도메인에서 두 번째 추가 기능을 활성화하고 첫 번째 추가 기능의 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 추가 기능을 활성화합니다.

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

형식 매개 변수

매개 변수

반품

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

예제

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

//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 찾은 경우 새 애플리케이션 도메인에 대한 구성 파일로 설정합니다.

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

형식 매개 변수

매개 변수

반품

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

예외

예제

다음 예에서는 다른 추가 기능에서 사용 중인 애플리케이션 도메인에서 추가 기능을 활성화합니다. 첫 번째 추가 기능에 대한 코드가 클래스에 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) 대한 친숙한 이름을 포함하도록 오버로드를 생성합니다.

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

형식 매개 변수

매개 변수

반품

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

예외

설명

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

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

형식 매개 변수

매개 변수

반품

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

예제

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

// 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 찾고 있는 경우 새 애플리케이션 도메인에 대한 구성 파일로 설정합니다.

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

형식 매개 변수

매개 변수

반품

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

설명

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

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

형식 매개 변수

매개 변수

반품

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

설명

애플리케이션 도메인 이름을 지정할 필요가 없는 경우 오버로드를 Activate<T>(AddInSecurityLevel) 사용합니다.

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