<Elemen Aplikasi> (.NET Native)

Artikel
07/13/2023

Berfungsi sebagai kontainer untuk jenis dan jenis anggota di seluruh aplikasi yang metadatanya tersedia untuk refleksi pada durasi, dan menerapkan kebijakan refleksi runtime ke semua elemen program dalam aplikasi.

<Elemen Aplikasi> Elemen <Directives> (rd.xml)

Sintaks

<Application 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. Dalam tabel Elemen Anak, kebijakan mengacu pada jenis metadata yang tersedia untuk elemen program tertentu pada durasi.

Atribut

Atribut	Jenis atribut	Deskripsi
`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, tetapi tidak mengaktifkan akses dinamis apa pun pada durasi.
`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.

Semua atribut

Nilai	Deskripsi
policy_setting	Pengaturan untuk kebijakan ini berlaku untuk jenis di aplikasi. Nilai yang mungkin adalah `All`, , `ExcludedAuto`, `Public`, `PublicAndInternal`, `Required Public`, `Required PublicAndInternal`, dan `Required All`. Untuk informasi selengkapnya, lihat Pengaturan Kebijakan Arahan Runtime.

Elemen Anak

Elemen	Deskripsi
<Majelis>	Menerapkan kebijakan ke semua jenis dalam rakitan tertentu.
<Namespace>	Menerapkan kebijakan ke semua jenis di namespace tertentu.
<Jenis>	Menerapkan kebijakan ke jenis tertentu, seperti kelas atau struktur.
<TypeInstantiation>	Menerapkan kebijakan ke jenis generik yang dibangun. Misalnya, <elemen TypeInstantiation> dapat digunakan untuk menentukan kebijakan untuk jenis `List<String>` .
<Metode>	Menerapkan kebijakan ke metode pada jenis tertentu.
<MethodInstantiation>	Menerapkan kebijakan ke metode generik yang dibangun.
<Properti>	Menerapkan kebijakan ke properti pada jenis tertentu.
<Bidang>	Menerapkan kebijakan ke bidang pada jenis tertentu.
<Kejadian>	Menerapkan kebijakan ke peristiwa pada jenis tertentu.

Elemen Induk

Elemen	Deskripsi
<Arahan>	Elemen akar dari file arahan runtime.

Keterangan

Elemen <Directives> dapat berisi nol atau satu <Application> elemen. Beberapa <Application> elemen dalam satu file arahan refleksi tidak didukung.

Elemen <Application> dapat digunakan dengan salah satu dari dua cara:

Sebagai kontainer untuk menentukan elemen program yang metadatanya diperlukan pada durasi. Dalam hal ini, <Application> elemen tidak perlu memiliki atribut apa pun. Pada waktu kompilasi, alat kompilator mencari semua pustaka, termasuk pustaka inti .NET Framework, untuk elemen program yang diidentifikasi oleh elemen anak dari <Application> elemen . Sebaliknya, alat pengkompilasi hanya mencari pustaka yang ditunjuk oleh <elemen Pustaka> untuk elemen program yang diidentifikasi oleh elemen <anak Pustaka>.
Sebagai elemen yang menetapkan kebijakan di seluruh aplikasi untuk refleksi, serialisasi, dan interop. Atribut <Application> elemen menentukan kebijakan di seluruh aplikasi, yang dapat ditimpa oleh elemen turunan yang ditentukan oleh <Application> elemen atau <Pustaka> .

Bagikan melalui