<Assembly> Element (.NET Native)

  • Artikel

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 perakitan, 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.

Atribut nama

Nilai Deskripsi
assembly_name Nama sederhana rakitan, tanpa ekstensi filenya. Atribut ini sesuai dengan AssemblyName.Name properti . Misalnya, nama assembly bernama Extensions.dll adalah "Extensions".

Anda juga dapat menentukan string *Application* literal 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 assembly. 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
<Namespace> 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 durasi. Elemen <Aplikasi> dapat memiliki elemen nol, satu, atau lebih <Assembly> .
<Perpustakaan> Menentukan rakitan yang berisi jenis dan jenis anggota yang metadatanya tersedia untuk refleksi pada durasi. Elemen <Pustaka> dapat memiliki nol atau satu <Assembly> elemen.

Keterangan

Elemen <Assembly> menentukan kebijakan runtime untuk semua jenis dalam assembly. 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 jika 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 anak 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.

Lihat juga