AddInToken.Activate Metod

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

Typparametrar

Parametrar

Returer

Värdvyn för tillägget.

Exempel

I följande exempel aktiveras ett tillägg i en automatiskt genererad programdomän med en angiven säkerhetsnivå. Sedan aktiveras ett andra tillägg i samma programdomän och bearbetas som det första med hjälp av det första tilläggets AddInEnvironment objekt.

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

Kommentarer

Den här metodens överlagring aktiverar tillägget i samma programdomän och process som tillägget som environment hämtades från.

Se även

• Add-Ins och utökningsbarhet

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

Typparametrar

Parametrar

Returer

Värdvyn för tillägget.

Exempel

I följande exempel visas hur du aktiverar ett tillägg som identifieras av den valda token i en automatiskt genererad programdomän med en angiven säkerhetsnivå.

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

Kommentarer

Den här metoden överbelastar tillägget till en automatiskt genererad programdomän. Om du vill ange ett namn för den nya programdomänen använder du överlagringen Activate<T>(AddInSecurityLevel, String) .

Den här metoden anger baskatalogen för programdomänen till platsen för tilläggssammansättningen. Den letar också efter konfigurationsfilen [addinassemblyname].dll.config och anger, om det hittas, att den är konfigurationsfilen för den nya programdomänen.

Se även

• Add-Ins och utökningsbarhet

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

Typparametrar

Parametrar

Returer

Värdvyn för tillägget.

Undantag

Exempel

I följande exempel aktiveras ett tillägg i en programdomän som används av ett annat tillägg. Koden för det första tillägget finns i AddInToken klassen .

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

Kommentarer

Om du vill aktivera ett tillägg i en automatiskt genererad programdomän använder du överlagringen Activate<T>(AddInSecurityLevel) för att generera en ny programdomän med en angiven säkerhetsnivå eller överlagringen Activate<T>(AddInSecurityLevel, String) för att inkludera ett eget namn för programdomänen.

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

Typparametrar

Parametrar

Returer

Värdvyn för tillägget.

Undantag

Kommentarer

Den här metoden överbelastar tillägget till en automatiskt genererad programdomän. Den anger baskatalogen för programdomänen som platsen för tilläggssammansättningen. Den letar också efter konfigurationsfilen [addinassemblyname].dll.config och anger, om den hittas, att den är konfigurationsfilen för den nya programdomänen.

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

Typparametrar

Parametrar

Returer

Värdvyn för tillägget.

Exempel

I följande exempel skapas en ny process och ett tillägg aktiveras i den processen med en fullständig säkerhetsnivå för förtroende.

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

Kommentarer

Den här metoden anger baskatalogen för programdomänen till platsen för tilläggssammansättningen. Den letar också efter konfigurationsfilen [addinassemblyname].dll.config och anger, om den hittas, att den är konfigurationsfilen för den nya programdomänen.

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

Typparametrar

Parametrar

Returer

Värdvyn för tillägget.

Kommentarer

Den här metoden anger baskatalogen för programdomänen till platsen för tilläggssammansättningen. Den letar också efter konfigurationsfilen [addinassemblyname].dll.config och anger, om den hittas, att den är konfigurationsfilen för den nya programdomänen.

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

Typparametrar

Parametrar

Returer

Värdvyn för tillägget.

Kommentarer

Om du inte behöver ange ett programdomännamn använder du överlagringen Activate<T>(AddInSecurityLevel) .

Den här metoden anger baskatalogen för programdomänen till platsen för tilläggssammansättningen. Den letar också efter konfigurationsfilen [addinassemblyname].dll.config och anger, om den hittas, att den är konfigurationsfilen för den nya programdomänen.