AddInController Klas

Definitie

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Overname

Object

AddInController

Voorbeelden

In het volgende voorbeeld wordt een invoegtoepassing in dezelfde omgeving geactiveerd als een eerder geactiveerde invoegtoepassing met behulp van een AddInController 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))

Opmerkingen

Gebruik deze klasse om de volgende taken uit te voeren:

• Gebruik de AddInEnvironment eigenschap om een AddInEnvironment object voor een invoegtoepassing te verkrijgen. Gebruik dat object vervolgens om andere invoegtoepassingen in hetzelfde toepassingsdomein te activeren en de oorspronkelijke invoegtoepassing te verwerken.

• Gebruik de AppDomain eigenschap om een AppDomain object voor een invoegtoepassing te verkrijgen. Gebruik dat object vervolgens om andere invoegtoepassingen in hetzelfde toepassingsdomein te activeren als de oorspronkelijke invoegtoepassing. Vanwege beperkingen bij externe communicatie tussen processen werkt dit scenario niet met invoegtoepassingen die in een afzonderlijk proces worden geactiveerd.

• Gebruik de Token eigenschap om een AddInToken object te verkrijgen dat een invoegtoepassing vertegenwoordigt.

• Sluit een invoegtoepassing af met de Shutdown methode.

Als u de controller voor een invoegtoepassing wilt ophalen, roept u de GetAddInController methode aan en geeft u een exemplaar van de invoegtoepassing door als parameter.