AddInController Klass

Definition

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Arv

Object

AddInController

Exempel

I följande exempel aktiveras ett tillägg i samma miljö som ett tidigare aktiverat tillägg med hjälp av ett AddInController 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

Använd den här klassen för att utföra följande uppgifter:

• Använd egenskapen AddInEnvironment för att hämta ett AddInEnvironment objekt för ett tillägg. Använd sedan objektet för att aktivera andra tillägg i samma programdomän och bearbeta som det ursprungliga tillägget.

• Använd egenskapen AppDomain för att hämta ett AppDomain objekt för ett tillägg. Använd sedan objektet för att aktivera andra tillägg i samma programdomän som det ursprungliga tillägget. Observera att på grund av begränsningar i fjärrkommunikation mellan processer fungerar inte det här scenariot med tillägg som aktiveras i en separat process.

• Använd egenskapen Token för att hämta ett AddInToken objekt som representerar ett tillägg.

• Stäng av ett tillägg med Shutdown -metoden.

Om du vill hämta kontrollanten för ett tillägg anropar GetAddInController du metoden och skickar en instans av tillägget som dess parameter.