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

需要完全信任權限。呼叫鏈結中的呼叫端沒有足夠的權限。

範例

下列範例會在另一個載入宏所使用的應用程式域中啟動載入宏。類別中會提供第一個載入宏的程序 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)

類型參數

參數

傳回

備註

適用於

其他資源