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 teruskan instans add-in sebagai parameternya.

Properti

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

Metode

Nama	Deskripsi
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 Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
Shutdown()	Menonaktifkan add-in.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)