AddInToken.Activate メソッド

定義

アドインをアクティブにします。Activates an add-in.

オーバーロード

Activate<T>(AddInEnvironment)

別のアドインの環境にあるアドインをアクティブにします。Activates an add-in in the environment of another add-in.

Activate<T>(AddInSecurityLevel)

新しいアプリケーション ドメインで、信頼レベルを指定してアドインをアクティブにします。Activates an add-in with a specified trust level in a new application domain.

Activate<T>(AppDomain)

既存のアプリケーション ドメイン内でアドインをアクティブにします。Activates an add-in in an existing application domain.

Activate<T>(PermissionSet)

新しいアプリケーション ドメインで、アクセス許可セットを指定してアドインをアクティブにします。Activates an add-in with a specified permission set in a new application domain.

Activate<T>(AddInProcess, AddInSecurityLevel)

外部プロセスの新しいアプリケーション ドメインで、信頼レベルを指定してアドインをアクティブにします。Activates an add-in in an external process, in a new application domain, and with a specified trust level.

Activate<T>(AddInProcess, PermissionSet)

外部プロセスの新しいアプリケーション ドメインで、アクセス許可セットを指定してアドインをアクティブにします。Activates an add-in in an external process, in a new application domain, and with a specified permission set.

Activate<T>(AddInSecurityLevel, String)

新しいアプリケーション ドメインで、名前と信頼レベルを指定してアドインをアクティブにします。Activates an add-in in a new application domain with a specified name and trust level.

Activate<T>(AddInEnvironment)

別のアドインの環境にあるアドインをアクティブにします。Activates an add-in in the environment of another add-in.

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

アドインのホスト ビューを表すインターフェイスまたは抽象基本型。The interface or abstract base type that represents the host view of the add-in.

パラメーター

environment
AddInEnvironment

元のアドインを含むアプリケーション ドメインおよびプロセス。The application domain and process that contains the original add-in.

戻り値

T

アドインのホスト ビュー。The host view of the add-in.

次の例では、指定されたセキュリティレベルで、自動的に生成されたアプリケーションドメインで1つのアドインをアクティブ化します。The following example activates one add-in in an automatically generated application domain with a specified security level. 次に、最初のアドインの AddInEnvironment オブジェクトを使用して、同じアプリケーションドメインとプロセスで2番目のアドインをアクティブにします。It then activates a second add-in in the same application domain and process as the first by using the first add-in's AddInEnvironment object.

// 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 を取得したアドインと同じアプリケーションドメインおよびプロセスでアドインをアクティブにします。This method overload activates the add-in in the same application domain and process as the add-in from which environment was obtained.

こちらもご覧ください

Activate<T>(AddInSecurityLevel)

新しいアプリケーション ドメインで、信頼レベルを指定してアドインをアクティブにします。Activates an add-in with a specified trust level in a new application domain.

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

アドインのホスト ビューを表すインターフェイスまたは抽象基本型。The interface or abstract base type that represents the host view of the add-in.

パラメーター

trustLevel
AddInSecurityLevel

信頼レベルを指定する列挙値の 1 つ。One of the enumeration values that specifies the trust level.

戻り値

T

アドインのホスト ビュー。The host view of the add-in.

次の例は、指定されたセキュリティレベルで自動的に生成されたアプリケーションドメインで、選択したトークンで識別されるアドインをアクティブ化する方法を示しています。The following example shows how to activate an add-in, identified by the chosen token, in an automatically generated application domain with a specified security level.

//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)

注釈

このメソッドオーバーロードは、自動的に生成されたアプリケーションドメインにアドインを読み込みます。This method overload loads the add-in into an automatically generated application domain. 新しいアプリケーションドメインの名前を指定する場合は、Activate<T>(AddInSecurityLevel, String) のオーバーロードを使用します。If you want to specify a name for the new application domain, use the Activate<T>(AddInSecurityLevel, String) overload.

このメソッドは、アプリケーションドメインの基本ディレクトリをアドインアセンブリの場所として設定します。This method sets the base directory for the application domain to be the location of the add-in assembly. また、構成ファイル [addinassemblyname] .dll .config が検索され、見つかった場合は、新しいアプリケーションドメインの構成ファイルとして設定されます。It also looks for the configuration file [addinassemblyname].dll.config and, if found, sets it to be the configuration file for the new application domain.

こちらもご覧ください

Activate<T>(AppDomain)

既存のアプリケーション ドメイン内でアドインをアクティブにします。Activates an add-in in an existing application domain.

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

アドインのホスト ビューを表すインターフェイスまたは抽象基本型。The interface or abstract base type that represents the host view of the add-in.

パラメーター

target
AppDomain

アドインをアクティブにするアプリケーション ドメイン。The application domain that the add-in should be activated in.

戻り値

T

アドインのホスト ビュー。The host view of the add-in.

例外

完全信頼アクセス許可が要求されます。Full-trust permission is demanded. 呼び出しチェイン内の呼び出し元が、十分なアクセス許可を保持していません。A caller in the call chain does not have sufficient permission.

次の例では、別のアドインによって使用されているアプリケーションドメインでアドインをアクティブにします。The following example activates an add-in in an application domain that is being used by another add-in. 最初のアドインのコードは、AddInToken クラスに用意されています。The code for the first add-in is provided in the AddInToken class.

// 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) オーバーロードを使用してアプリケーションドメインのフレンドリ名を含めます。To activate an add-in in an automatically generated application domain, use the Activate<T>(AddInSecurityLevel) overload to generate a new application domain with a specified security level or the Activate<T>(AddInSecurityLevel, String) overload to include a friendly name for the application domain.

Activate<T>(PermissionSet)

新しいアプリケーション ドメインで、アクセス許可セットを指定してアドインをアクティブにします。Activates an add-in with a specified permission set in a new application domain.

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

アドインのホスト ビューを表すインターフェイスまたは抽象基本型。The interface or abstract base type that represents the host view of the add-in.

パラメーター

permissions
PermissionSet

アドインに付与するアクセス許可。The permissions granted for the add-in.

戻り値

T

アドインのホスト ビュー。The host view of the add-in.

例外

permissionsnull です。permissions is null.

注釈

このメソッドオーバーロードは、自動的に生成されたアプリケーションドメインにアドインを読み込みます。This method overload loads the add-in into an automatically generated application domain. これにより、アプリケーションドメインのベースディレクトリがアドインアセンブリの場所に設定されます。It sets the base directory for the application domain to be the location of the add-in assembly. また、構成ファイル [addinassemblyname].dll.config が検索され、見つかった場合は、新しいアプリケーションドメインの構成ファイルとして設定されます。It also looks for the configuration file [addinassemblyname].dll.config and, if found, sets it to be the configuration file for the new application domain.

Activate<T>(AddInProcess, AddInSecurityLevel)

外部プロセスの新しいアプリケーション ドメインで、信頼レベルを指定してアドインをアクティブにします。Activates an add-in in an external process, in a new application domain, and with a specified trust level.

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

アドインのホスト ビューを表すインターフェイスまたは抽象基本型。The interface or abstract base type that represents the host view of the add-in.

パラメーター

process
AddInProcess

アドインをアクティブ化する外部プロセス。The external process in which to activate the add-in.

level
AddInSecurityLevel

信頼レベルを指定する列挙値の 1 つ。One of the enumeration values that specifies the trust level.

戻り値

T

アドインのホスト ビュー。The host view of the add-in.

次の例では、新しいプロセスを作成し、そのプロセス内で完全な信頼セキュリティレベルを使用してアドインをアクティブにします。The following example creates a new process and activates an add-in in that process with a full trust security level.

// 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)

注釈

このメソッドは、アプリケーションドメインの基本ディレクトリをアドインアセンブリの場所として設定します。This method sets the base directory for the application domain to be the location of the add-in assembly. また、構成ファイル [addinassemblyname].dll.config が検索され、見つかった場合は、新しいアプリケーションドメインの構成ファイルとして設定されます。It also looks for the configuration file [addinassemblyname].dll.config and, if found, sets it to be the configuration file for the new application domain.

Activate<T>(AddInProcess, PermissionSet)

外部プロセスの新しいアプリケーション ドメインで、アクセス許可セットを指定してアドインをアクティブにします。Activates an add-in in an external process, in a new application domain, and with a specified permission set.

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

アドインのホスト ビューを表すインターフェイスまたは抽象基本型。The interface or abstract base type that represents the host view of the add-in.

パラメーター

process
AddInProcess

アドインをアクティブ化する外部プロセス。The external process in which to activate the add-in.

permissionSet
PermissionSet

アドインに付与する必要なアクセス許可セット。The required permission set granted for the add-in.

戻り値

T

アドインのホスト ビュー。The host view of the add-in.

注釈

このメソッドは、アプリケーションドメインの基本ディレクトリをアドインアセンブリの場所として設定します。This method sets the base directory for the application domain to be the location of the add-in assembly. また、構成ファイル [addinassemblyname].dll.config が検索され、見つかった場合は、新しいアプリケーションドメインの構成ファイルとして設定されます。It also looks for the configuration file [addinassemblyname].dll.config and, if found, sets it to be the configuration file for the new application domain.

Activate<T>(AddInSecurityLevel, String)

新しいアプリケーション ドメインで、名前と信頼レベルを指定してアドインをアクティブにします。Activates an add-in in a new application domain with a specified name and trust level.

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

アドインのホスト ビューを表すインターフェイスまたは抽象基本型。The interface or abstract base type that represents the host view of the add-in.

パラメーター

trustLevel
AddInSecurityLevel

信頼レベルを指定する列挙値の 1 つ。One of the enumeration values that specifies the trust level.

appDomainName
String

新しいアプリケーション ドメインに割り当てる表示名。The friendly name to assign to the new application domain.

戻り値

T

アドインのホスト ビュー。The host view of the add-in.

注釈

アプリケーションドメイン名を指定する必要がない場合は、Activate<T>(AddInSecurityLevel) のオーバーロードを使用します。If you do not need to specify an application domain name, use the Activate<T>(AddInSecurityLevel) overload.

このメソッドは、アプリケーションドメインの基本ディレクトリをアドインアセンブリの場所として設定します。This method sets the base directory for the application domain to be the location of the add-in assembly. また、構成ファイル [addinassemblyname].dll.config が検索され、見つかった場合は、新しいアプリケーションドメインの構成ファイルとして設定されます。It also looks for the configuration file [addinassemblyname].dll.config and, if found, sets it to be the configuration file for the new application domain.

適用対象