AddInController Kelas

Definisi

Ruang nama:

System.AddIn.Hosting

Rakitan:

System.AddIn.dll

Menyediakan akses ke add-in untuk berbagai tugas.

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Warisan

Object

AddInController

Contoh

Contoh berikut mengaktifkan add-in dalam lingkungan yang sama dengan add-in yang diaktifkan sebelumnya dengan menggunakan AddInController objek .

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

Keterangan

Gunakan kelas ini untuk melakukan tugas berikut:

• AddInEnvironment Gunakan properti untuk mendapatkan AddInEnvironment objek untuk add-in. Kemudian gunakan objek tersebut untuk mengaktifkan add-in lain di domain aplikasi yang sama dan proses sebagai add-in asli.

• AppDomain Gunakan properti untuk mendapatkan AppDomain objek untuk add-in. Kemudian gunakan objek tersebut untuk mengaktifkan add-in lain di domain aplikasi yang sama dengan add-in asli. Perhatikan bahwa karena keterbatasan dalam jarak jauh lintas proses, skenario ini tidak akan berfungsi dengan add-in yang diaktifkan dalam proses terpisah.

• Token Gunakan properti untuk mendapatkan AddInToken objek yang mewakili add-in.

• Matikan add-in dengan Shutdown metode .

Untuk mendapatkan pengontrol untuk add-in, panggil GetAddInController metode dan berikan instans add-in sebagai parameternya.

Properti

AddInEnvironment	AddInEnvironment Mendapatkan objek .
AppDomain	Mendapatkan domain aplikasi yang berisi add-in.
Token	Mendapatkan token yang mewakili add-in.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetAddInController(Object)	Mendapatkan pengontrol untuk add-in.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
Shutdown()	Menonaktifkan add-in.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)