<Assembly> Element (.NET Native)
Menerapkan kebijakan refleksi runtime ke semua jenis dalam rakitan tertentu.
Sintaks
<Assembly Name="assembly_name"
Activate="policy_setting"
Browse="policy_setting"
Dynamic="policy_setting"
Serialize="policy_setting"
DataContractSerializer="policy_setting"
DataContractJsonSerializer="policy_setting"
XmlSerializer="policy_setting"
MarshalObject="policy_setting"
MarshalDelegate="policy_setting"
MarshalStructure="policy_setting" />
Atribut dan Elemen
Bagian berikut menjelaskan atribut, elemen turunan, dan elemen induk.
Atribut
Atribut | Jenis atribut | Deskripsi |
---|---|---|
Name |
Umum | Atribut yang diperlukan. Menentukan nama sederhana rakitan. |
Activate |
Refleksi | Atribut opsional. Mengontrol akses runtime ke konstruktor untuk mengaktifkan aktivasi instans. |
Browse |
Refleksi | Atribut opsional. Mengontrol kueri untuk informasi tentang atau menghitung jenis dalam rakitan, tetapi tidak mengaktifkan akses dinamis apa pun pada waktu proses. |
Dynamic |
Refleksi | Atribut opsional. Mengontrol akses runtime ke semua anggota jenis, termasuk konstruktor, metode, bidang, properti, dan peristiwa, untuk mengaktifkan pemrograman dinamis. |
Serialize |
Serialisasi | Atribut opsional. Mengontrol akses runtime ke konstruktor, bidang, dan properti, untuk memungkinkan instans jenis diserialisasikan dan dideserialisasi oleh pustaka seperti serializer Newtonsoft JSON. |
DataContractSerializer |
Serialisasi | Atribut opsional. Mengontrol kebijakan untuk serialisasi yang menggunakan System.Runtime.Serialization.DataContractSerializer kelas . |
DataContractJsonSerializer |
Serialisasi | Atribut opsional. Mengontrol kebijakan untuk serialisasi JSON yang menggunakan System.Runtime.Serialization.Json.DataContractJsonSerializer kelas . |
XmlSerializer |
Serialisasi | Atribut opsional. Mengontrol kebijakan untuk serialisasi XML yang menggunakan System.Xml.Serialization.XmlSerializer kelas . |
MarshalObject |
Interop | Atribut opsional. Mengontrol kebijakan untuk marshaling jenis referensi ke Windows Runtime dan COM. |
MarshalDelegate |
Interop | Atribut opsional. Mengontrol kebijakan untuk marshaling mendelegasikan jenis sebagai penunjuk fungsi ke kode asli. |
MarshalStructure |
Interop | Atribut opsional. Mengontrol kebijakan untuk marshaling struktur ke kode asli. |
Atribut nama
Nilai | Deskripsi |
---|---|
assembly_name | Nama sederhana rakitan, tanpa ekstensi filenya. Atribut ini sesuai dengan AssemblyName.Name properti . Misalnya, nama rakitan bernama Extensions.dll adalah "Ekstensi". Anda juga dapat menentukan string *Application* harfiah untuk menerapkan kebijakan ke semua rakitan dalam paket aplikasi Anda, baik rakitan tersebut dimuat atau tidak. *Application* tidak pernah menerapkan kebijakan ke rakitan .NET Framework. |
Semua atribut lainnya
Nilai | Deskripsi |
---|---|
policy_setting | Pengaturan yang akan diterapkan ke jenis kebijakan ini untuk semua jenis dalam rakitan. Nilai yang mungkin adalah All , , Excluded Auto , Public , PublicAndInternal , Required Public , Required PublicAndInternal , dan Required All . Untuk informasi selengkapnya, lihat Pengaturan Kebijakan Arahan Runtime. |
Elemen Anak
Elemen | Deskripsi |
---|---|
<Namespace Layanan> | Menerapkan kebijakan refleksi ke semua jenis di namespace layanan anak. |
<Jenis> | Menerapkan kebijakan refleksi ke jenis. |
<TypeInstantiation> | Menerapkan kebijakan refleksi ke jenis generik yang dibangun. |
Elemen Induk
Elemen | Deskripsi |
---|---|
<Aplikasi> | Berfungsi sebagai kontainer untuk jenis dan jenis anggota di seluruh aplikasi yang metadatanya tersedia untuk refleksi pada waktu proses. Elemen <Aplikasi> dapat memiliki nol, satu, atau beberapa <Assembly> elemen. |
<Pustaka> | Menentukan rakitan yang berisi jenis dan jenis anggota yang metadatanya tersedia untuk refleksi pada waktu proses. Elemen <Pustaka> dapat memiliki nol atau satu <Assembly> elemen. |
Keterangan
Elemen <Assembly>
menentukan kebijakan runtime untuk semua jenis dalam rakitan. Ini berbeda dari <elemen Pustaka> , yang menentukan pustaka tetapi bergantung pada elemen turunannya untuk menentukan kebijakan refleksi runtime. Elemen ini <Assembly>
berlaku untuk semua jenis dalam rakitan kecuali ditimpa oleh elemen turunan.
Contoh berikut menunjukkan bagaimana Anda dapat menerapkan kebijakan runtime ke semua jenis dalam rakitan dalam paket aplikasi Anda dengan menetapkan Name
atribut nilai "*Aplikasi*". Elemen <Assembly>
harus merupakan turunan dari <elemen Aplikasi> .
<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
<Application>
<Assembly Name="*Application*" Dynamic="Required All" />
</Application>
</Directives>
Atribut Activate
, Browse
, Dynamic
, dan Serialize
semuanya opsional. Namun, <Assembly>
elemen harus berisi setidaknya salah satu atribut ini.