XmlnsPrefixAttribute Kelas

Definisi

Ruang nama:

System.Windows.Markup

Rakitan:

System.Xaml.dll

Mengidentifikasi awalan yang direkomendasikan untuk dikaitkan dengan namespace XAML untuk penggunaan XAML, saat menulis elemen dan atribut dalam file XAML (serialisasi) atau saat berinteraksi dengan lingkungan desain yang memiliki fitur pengeditan XAML.

public ref class XmlnsPrefixAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)]
public sealed class XmlnsPrefixAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)>]
type XmlnsPrefixAttribute = class
    inherit Attribute

Public NotInheritable Class XmlnsPrefixAttribute
Inherits Attribute

Warisan

Object

Attribute

XmlnsPrefixAttribute

Atribut

AttributeUsageAttribute

Keterangan

Prosesor atau kerangka kerja XAML yang menggabungkan XAML, atau proses apa pun yang melakukan serialisasi XAML, umumnya harus mematuhi awalan yang direkomendasikan. Awalan mungkin diperlukan dalam kasus apa pun di mana awalan dari pemetaan tertentu di sumber XAML asli entah bagaimana dipertahankan dalam grafik objek runtime atau disimpan oleh kerangka kerja atau teknologi. Kerangka kerja mungkin memiliki preferensi khusus tentang cara membuat serialisasi jenisnya sendiri yang mengabaikan awalan yang direkomendasikan dari rakitannya sendiri; ini mungkin dilakukan untuk secara konsisten mempromosikan namespace XAML default. Namun, kerangka kerja seperti itu masih harus memberikan awalan yang direkomendasikan untuk kemungkinan penggunaan pihak ketiga dan alat dari jenis XAML-nya. Lihat bagian "Praktik Terbaik untuk Dukungan Designer XAML atau Serialisasi Umum" di bawah ini.

Rekomendasi umum untuk prefiks adalah menggunakan string pendek, karena awalan biasanya diterapkan ke semua elemen berseri yang berasal dari namespace XAML. Panjang string awalan dapat memiliki efek nyata pada ukuran output XAML serial.

Jika awalan yang diminta sudah digunakan oleh pengidentifikasi namespace XAML lain yang ditemui/diserialisasikan sebelumnya, perilakunya tidak ditentukan (perilaku hingga setiap implementasi prosesor XAML individu).

Dalam kebanyakan kasus, Anda hanya berlaku XmlnsPrefixAttribute jika Anda juga telah menerapkan setidaknya satu XmlnsDefinitionAttribute di perakitan untuk namespace XAML yang sama.

Dalam versi .NET Framework sebelumnya, kelas ini ada di rakitan khusus WPF WindowsBase. Di .NET Framework 4, XmlnsPrefixAttribute berada di rakitan System.Xaml. Untuk informasi selengkapnya, lihat Jenis yang Dimigrasikan dari WPF ke System.Xaml.

Praktik Terbaik untuk Dukungan Designer XAML atau Serialisasi Umum

Bahkan jika Anda ingin namespace XAML terkait menjadi namespace XAML default dalam sebagian besar kasus penggunaan untuk kerangka kerja atau pustaka Anda, Anda masih harus menentukan string yang tidak kosong sebagai awalan yang direkomendasikan untuk namespace XAML. Informasi namespace XAML default dibawa dalam file XAML individual dan aliran simpul XAML. Namespace XAML default dan bagaimana didefinisikan dalam sumber XAML tertentu dapat dengan mudah diabadikan untuk serialisasi per kasus tanpa menggunakan XmlnsPrefixAttribute. Namun, XmlnsPrefixAttribute berguna untuk kasus di mana penulis XAML telah memilih untuk memetakan namespace XAML default ke sesuatu yang lain. Dalam skenario ini editor teks XAML yang disematkan di lingkungan desain dapat digunakan XmlnsPrefixAttribute sebagai petunjuk untuk pemetaan namespace xmlns XAML awal. Atau lingkungan desain dapat menambahkan pemetaan just-in-time ke XAML yang mendukung untuk metafora desain seperti menyeret objek keluar dari kotak alat dan ke permukaan desain visual. Selain itu, dapat dibayangkan bahwa perancang dapat secara bersamaan mendukung beberapa kerangka kerja yang mengaktifkan XAML, dan memiliki serializer XAML umum yang bergantung pada .NET Framework Layanan XAML daripada serialisasi khusus kerangka kerja. Menentukan XmlnsPrefixAttribute untuk skenario ini membantu membuat penggunaan XAML untuk jenis Anda lebih portabel dan kuat jika XAML dipertukarkan antara alat desain, atau menjalani perjalanan pulang pergi antara editor XAML dan konsumen lain seperti kompilator markup atau serialisasi lainnya.

Konstruktor

XmlnsPrefixAttribute(String, String)

Menginisialisasi instans baru kelas XmlnsPrefixAttribute.

Properti

Prefix	Mendapatkan awalan yang direkomendasikan yang terkait dengan atribut ini.
TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)
XmlNamespace	Mendapatkan pengidentifikasi namespace XAML yang terkait dengan atribut ini.

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Atribut CLR terkait XAML untuk jenis dan pustaka kustom
• Tentukan jenis kustom untuk digunakan dengan Layanan XAML .NET
• Layanan XAML