AddInToken.Activate Metoda

Reference

Definice

Obor názvů:: System.AddIn.Hosting

Sestavení:: System.AddIn.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Aktivuje doplněk.

Přetížení

Activate<T>(AddInEnvironment)	Aktivuje doplněk v prostředí jiného doplňku.
Activate<T>(AddInSecurityLevel)	Aktivuje doplněk se zadanou úrovní důvěryhodnosti v nové doméně aplikace.
Activate<T>(AppDomain)	Aktivuje doplněk v existující doméně aplikace.
Activate<T>(PermissionSet)	Aktivuje doplněk se zadaným oprávněním nastaveným v nové doméně aplikace.
Activate<T>(AddInProcess, AddInSecurityLevel)	Aktivuje doplněk v externím procesu, v nové doméně aplikace a se zadanou úrovní důvěryhodnosti.
Activate<T>(AddInProcess, PermissionSet)	Aktivuje doplněk v externím procesu, v nové doméně aplikace a se zadanou sadou oprávnění.
Activate<T>(AddInSecurityLevel, String)	Aktivuje doplněk v nové doméně aplikace se zadaným názvem a úrovní důvěryhodnosti.

Activate<T>(AddInEnvironment)

Aktivuje doplněk v prostředí jiného doplňku.

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

Parametry typu

T

Rozhraní nebo abstraktní základní typ, který představuje zobrazení hostitele doplňku.

Parametry

environment: AddInEnvironment

Doména aplikace a proces, který obsahuje původní doplněk.

Návraty

Zobrazení hostitele doplňku.

Příklady

Následující příklad aktivuje jeden doplněk v automaticky generované doméně aplikace se zadanou úrovní zabezpečení. Potom aktivuje druhý doplněk ve stejné doméně aplikace a proces jako první pomocí objektu prvního doplňku 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))

Poznámky

Tato metoda přetížení aktivuje doplněk ve stejné doméně aplikace a procesu jako doplněk, ze kterého environment byl získán.

Viz také

Doplňky a rozšiřitelnost

Platí pro

Activate<T>(AddInSecurityLevel)

Aktivuje doplněk se zadanou úrovní důvěryhodnosti v nové doméně aplikace.

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

Parametry typu

T

Rozhraní nebo abstraktní základní typ, který představuje zobrazení hostitele doplňku.

Parametry

trustLevel: AddInSecurityLevel

Jedna z hodnot výčtu, která určuje úroveň důvěryhodnosti.

Návraty

Zobrazení hostitele doplňku.

Příklady

Následující příklad ukazuje, jak aktivovat doplněk identifikovaný zvoleným tokenem v automaticky generované doméně aplikace se zadanou úrovní zabezpečení.

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

Poznámky

Tato metoda přetížení načte doplněk do automaticky generované domény aplikace. Pokud chcete zadat název nové domény aplikace, použijte Activate<T>(AddInSecurityLevel, String) přetížení.

Tato metoda nastaví základní adresář domény aplikace jako umístění sestavení doplňku. Vyhledá také konfigurační soubor [addinassemblyname].dll.config a pokud ho najde, nastaví ho jako konfigurační soubor pro novou doménu aplikace.

Viz také

Doplňky a rozšiřitelnost

Platí pro

Activate<T>(AppDomain)

Aktivuje doplněk v existující doméně aplikace.

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

Parametry typu

T

Rozhraní nebo abstraktní základní typ, který představuje zobrazení hostitele doplňku.

Parametry

target: AppDomain

Doména aplikace, ve které se má doplněk aktivovat.

Návraty

Zobrazení hostitele doplňku.

Výjimky

SecurityException

Vyžaduje se oprávnění s úplným vztahem důvěryhodnosti. Volající v řetězci volání nemá dostatečná oprávnění.

Příklady

Následující příklad aktivuje doplněk v doméně aplikace, kterou používá jiný doplněk. Kód prvního doplňku je k dispozici ve AddInToken třídě .

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

Poznámky

Chcete-li aktivovat doplněk v automaticky generované doméně aplikace, použijte Activate<T>(AddInSecurityLevel) přetížení k vygenerování nové domény aplikace se zadanou úrovní zabezpečení nebo Activate<T>(AddInSecurityLevel, String) přetížení, pokud chcete zahrnout popisný název domény aplikace.

Platí pro

Activate<T>(PermissionSet)

Aktivuje doplněk se zadaným oprávněním nastaveným v nové doméně aplikace.

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

Parametry typu

T

Rozhraní nebo abstraktní základní typ, který představuje zobrazení hostitele doplňku.

Parametry

permissions: PermissionSet

Oprávnění udělená doplňku

Návraty

Zobrazení hostitele doplňku.

Výjimky

ArgumentNullException

permissions je null.

Poznámky

Tato metoda přetížení načte doplněk do automaticky generované domény aplikace. Nastaví základní adresář domény aplikace jako umístění sestavení doplňku. Vyhledá také konfigurační soubor [addinassemblyname].dll.config , a pokud ho najde, nastaví ho jako konfigurační soubor pro novou doménu aplikace.

Platí pro

Activate<T>(AddInProcess, AddInSecurityLevel)

Aktivuje doplněk v externím procesu, v nové doméně aplikace a se zadanou úrovní důvěryhodnosti.

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

Parametry typu

T

Rozhraní nebo abstraktní základní typ, který představuje zobrazení hostitele doplňku.

Parametry

process: AddInProcess

Externí proces, ve kterém se doplněk aktivuje.

level: AddInSecurityLevel

Jedna z hodnot výčtu, která určuje úroveň důvěryhodnosti.

Návraty

Zobrazení hostitele doplňku.

Příklady

Následující příklad vytvoří nový proces a aktivuje doplněk v tomto procesu s úrovní zabezpečení s úplným vztahem důvěryhodnosti.

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

Poznámky

Tato metoda nastaví základní adresář domény aplikace jako umístění sestavení doplňku. Vyhledá také konfigurační soubor [addinassemblyname].dll.config , a pokud ho najde, nastaví ho jako konfigurační soubor pro novou doménu aplikace.

Platí pro

Activate<T>(AddInProcess, PermissionSet)

Aktivuje doplněk v externím procesu, v nové doméně aplikace a se zadanou sadou oprávnění.

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

Parametry typu

T

Rozhraní nebo abstraktní základní typ, který představuje zobrazení hostitele doplňku.

Parametry

process: AddInProcess

Externí proces, ve kterém se doplněk aktivuje.

permissionSet: PermissionSet

Požadovaná sada oprávnění udělená doplňku.

Návraty

Zobrazení hostitele doplňku.

Poznámky

Platí pro

Activate<T>(AddInSecurityLevel, String)

Aktivuje doplněk v nové doméně aplikace se zadaným názvem a úrovní důvěryhodnosti.

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

Parametry typu

T

Rozhraní nebo abstraktní základní typ, který představuje zobrazení hostitele doplňku.

Parametry

trustLevel: AddInSecurityLevel

Jedna z hodnot výčtu, která určuje úroveň důvěryhodnosti.

appDomainName: String

Popisný název, který se má přiřadit k nové doméně aplikace.

Návraty

Zobrazení hostitele doplňku.

Poznámky

Pokud není nutné zadávat název domény aplikace, použijte Activate<T>(AddInSecurityLevel) přetížení.

Platí pro

Sdílet prostřednictvím

AddInToken.Activate Metoda

Definice

Přetížení

Activate<T>(AddInEnvironment)

Parametry typu

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Activate<T>(AddInSecurityLevel)

Parametry typu

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Activate<T>(AppDomain)

Parametry typu

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

Activate<T>(PermissionSet)

Parametry typu

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Activate<T>(AddInProcess, AddInSecurityLevel)

Parametry typu

Parametry

Návraty

Příklady

Poznámky

Platí pro

Activate<T>(AddInProcess, PermissionSet)

Parametry typu

Parametry

Návraty

Poznámky

Platí pro

Activate<T>(AddInSecurityLevel, String)

Parametry typu

Parametry

Návraty

Poznámky

Platí pro

Další materiály