AddInToken.Activate Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengaktifkan add-in.
Overload
| Activate<T>(AddInEnvironment) |
Mengaktifkan add-in di lingkungan add-in lain. |
| Activate<T>(AddInSecurityLevel) |
Mengaktifkan add-in dengan tingkat kepercayaan tertentu di domain aplikasi baru. |
| Activate<T>(AppDomain) |
Mengaktifkan add-in di domain aplikasi yang sudah ada. |
| Activate<T>(PermissionSet) |
Mengaktifkan add-in dengan seperangkat izin tertentu di domain aplikasi baru. |
| Activate<T>(AddInProcess, AddInSecurityLevel) |
Mengaktifkan add-in dalam proses eksternal, di domain aplikasi baru, dan dengan tingkat kepercayaan tertentu. |
| Activate<T>(AddInProcess, PermissionSet) |
Mengaktifkan add-in dalam proses eksternal, di domain aplikasi baru, dan dengan kumpulan izin yang ditentukan. |
| Activate<T>(AddInSecurityLevel, String) |
Mengaktifkan add-in di domain aplikasi baru dengan nama dan tingkat kepercayaan tertentu. |
Activate<T>(AddInEnvironment)
Mengaktifkan add-in di lingkungan add-in lain.
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 -> 'TPublic Function Activate(Of T) (environment As AddInEnvironment) As TJenis parameter
- T
Antarmuka atau jenis dasar abstrak yang mewakili tampilan host add-in.
Parameter
- environment
- AddInEnvironment
Domain dan proses aplikasi yang berisi add-in asli.
Mengembalikan
Tampilan host add-in.
Contoh
Contoh berikut mengaktifkan satu add-in dalam domain aplikasi yang dihasilkan secara otomatis dengan tingkat keamanan tertentu. Kemudian mengaktifkan add-in kedua di domain aplikasi yang sama dan memproses sebagai yang pertama dengan menggunakan objek add-in AddInEnvironment pertama.
// 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
Metode ini kelebihan beban mengaktifkan add-in di domain aplikasi yang sama dan memproses sebagai add-in yang environment diperoleh.
Lihat juga
Berlaku untuk
Activate<T>(AddInSecurityLevel)
Mengaktifkan add-in dengan tingkat kepercayaan tertentu di domain aplikasi baru.
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 -> 'TPublic Function Activate(Of T) (trustLevel As AddInSecurityLevel) As TJenis parameter
- T
Antarmuka atau jenis dasar abstrak yang mewakili tampilan host add-in.
Parameter
- trustLevel
- AddInSecurityLevel
Salah satu nilai enumerasi yang menentukan tingkat kepercayaan.
Mengembalikan
Tampilan host add-in.
Contoh
Contoh berikut menunjukkan cara mengaktifkan add-in, yang diidentifikasi oleh token yang dipilih, dalam domain aplikasi yang dibuat secara otomatis dengan tingkat keamanan tertentu.
//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)
Keterangan
Metode ini memuat add-in ke dalam domain aplikasi yang dihasilkan secara otomatis. Jika Anda ingin menentukan nama untuk domain aplikasi baru, gunakan Activate<T>(AddInSecurityLevel, String) kelebihan beban.
Metode ini mengatur direktori dasar untuk domain aplikasi menjadi lokasi perakitan add-in. Ini juga mencari file konfigurasi [addinassemblyname].dll.config dan, jika ditemukan, mengaturnya menjadi file konfigurasi untuk domain aplikasi baru.
Lihat juga
Berlaku untuk
Activate<T>(AppDomain)
Mengaktifkan add-in di domain aplikasi yang sudah ada.
public:
generic <typename T>
T Activate(AppDomain ^ target);public T Activate<T> (AppDomain target);member this.Activate : AppDomain -> 'TPublic Function Activate(Of T) (target As AppDomain) As TJenis parameter
- T
Antarmuka atau jenis dasar abstrak yang mewakili tampilan host add-in.
Parameter
- target
- AppDomain
Domain aplikasi tempat add-in harus diaktifkan.
Mengembalikan
Tampilan host add-in.
Pengecualian
Izin kepercayaan penuh diminta. Penelepon dalam rantai panggilan tidak memiliki izin yang memadai.
Contoh
Contoh berikut mengaktifkan add-in di domain aplikasi yang sedang digunakan oleh add-in lain. Kode untuk add-in pertama disediakan di AddInToken kelas .
// 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))
Keterangan
Untuk mengaktifkan add-in di domain aplikasi yang dihasilkan secara otomatis, gunakan Activate<T>(AddInSecurityLevel) kelebihan beban untuk menghasilkan domain aplikasi baru dengan tingkat keamanan tertentu atau Activate<T>(AddInSecurityLevel, String) kelebihan beban untuk menyertakan nama yang mudah diingat untuk domain aplikasi.
Berlaku untuk
Activate<T>(PermissionSet)
Mengaktifkan add-in dengan seperangkat izin tertentu di domain aplikasi baru.
public:
generic <typename T>
T Activate(System::Security::PermissionSet ^ permissions);public T Activate<T> (System.Security.PermissionSet permissions);member this.Activate : System.Security.PermissionSet -> 'TPublic Function Activate(Of T) (permissions As PermissionSet) As TJenis parameter
- T
Antarmuka atau jenis dasar abstrak yang mewakili tampilan host add-in.
Parameter
- permissions
- PermissionSet
Izin yang diberikan untuk add-in.
Mengembalikan
Tampilan host add-in.
Pengecualian
permissionsadalah null.
Keterangan
Metode ini memuat add-in ke dalam domain aplikasi yang dihasilkan secara otomatis. Ini mengatur direktori dasar untuk domain aplikasi menjadi lokasi perakitan add-in. Ini juga mencari file [addinassemblyname].dll.config konfigurasi dan, jika ditemukan, mengaturnya menjadi file konfigurasi untuk domain aplikasi baru.
Berlaku untuk
Activate<T>(AddInProcess, AddInSecurityLevel)
Mengaktifkan add-in dalam proses eksternal, di domain aplikasi baru, dan dengan tingkat kepercayaan tertentu.
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 -> 'TPublic Function Activate(Of T) (process As AddInProcess, level As AddInSecurityLevel) As TJenis parameter
- T
Antarmuka atau jenis dasar abstrak yang mewakili tampilan host add-in.
Parameter
- process
- AddInProcess
Proses eksternal untuk mengaktifkan add-in.
- level
- AddInSecurityLevel
Salah satu nilai enumerasi yang menentukan tingkat kepercayaan.
Mengembalikan
Tampilan host add-in.
Contoh
Contoh berikut membuat proses baru dan mengaktifkan add-in dalam proses tersebut dengan tingkat keamanan kepercayaan penuh.
// 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)
Keterangan
Metode ini mengatur direktori dasar untuk domain aplikasi menjadi lokasi perakitan add-in. Ini juga mencari file [addinassemblyname].dll.config konfigurasi dan, jika ditemukan, mengaturnya menjadi file konfigurasi untuk domain aplikasi baru.
Berlaku untuk
Activate<T>(AddInProcess, PermissionSet)
Mengaktifkan add-in dalam proses eksternal, di domain aplikasi baru, dan dengan kumpulan izin yang ditentukan.
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 -> 'TPublic Function Activate(Of T) (process As AddInProcess, permissionSet As PermissionSet) As TJenis parameter
- T
Antarmuka atau jenis dasar abstrak yang mewakili tampilan host add-in.
Parameter
- process
- AddInProcess
Proses eksternal untuk mengaktifkan add-in.
- permissionSet
- PermissionSet
Set izin yang diperlukan diberikan untuk add-in.
Mengembalikan
Tampilan host add-in.
Keterangan
Metode ini mengatur direktori dasar untuk domain aplikasi menjadi lokasi perakitan add-in. Ini juga mencari file [addinassemblyname].dll.config konfigurasi dan, jika ditemukan, mengaturnya menjadi file konfigurasi untuk domain aplikasi baru.
Berlaku untuk
Activate<T>(AddInSecurityLevel, String)
Mengaktifkan add-in di domain aplikasi baru dengan nama dan tingkat kepercayaan tertentu.
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 -> 'TPublic Function Activate(Of T) (trustLevel As AddInSecurityLevel, appDomainName As String) As TJenis parameter
- T
Antarmuka atau jenis dasar abstrak yang mewakili tampilan host add-in.
Parameter
- trustLevel
- AddInSecurityLevel
Salah satu nilai enumerasi yang menentukan tingkat kepercayaan.
- appDomainName
- String
Nama yang mudah diingat untuk ditetapkan ke domain aplikasi baru.
Mengembalikan
Tampilan host add-in.
Keterangan
Jika Anda tidak perlu menentukan nama domain aplikasi, gunakan Activate<T>(AddInSecurityLevel) kelebihan beban.
Metode ini mengatur direktori dasar untuk domain aplikasi menjadi lokasi perakitan add-in. Ini juga mencari file [addinassemblyname].dll.config konfigurasi dan, jika ditemukan, mengaturnya menjadi file konfigurasi untuk domain aplikasi baru.
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk