XmlnsPrefixAttribute Sınıf

Tanım

Bir XAML dosyasında öğe ve öznitelik yazarken (serileştirme) veya XAML düzenleme özelliklerine sahip bir tasarım ortamıyla etkileşim kurarken, XAML kullanımı için bir XAML ad alanıyla ilişkilendirmek için önerilen bir ön ek tanımlar.

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
Devralma
XmlnsPrefixAttribute
Öznitelikler

Açıklamalar

XAML içeren XAML işlemcileri veya çerçeveleri veya XAML serileştirmesi gerçekleştiren herhangi bir işlem genellikle önerilen ön eke uygun olmalıdır. Ön ek, özgün XAML kaynağındaki belirli eşlemelerden gelen ön eklerin çalışma zamanı nesne grafında bir şekilde korunmadığı veya bir çerçeve veya teknoloji tarafından başka bir şekilde depolanmadığı her durumda gerekli olabilir. Çerçeve, önerilen ön eki kendi derlemelerinden yoksayan kendi türlerini seri hale getirmek için belirli tercihlere sahip olabilir; bu, varsayılan bir XAML ad alanını tutarlı bir şekilde yükseltmek için yapılabilir. Ancak, böyle bir çerçeve yine de XAML türlerinin olası üçüncü taraf ve araç kullanımları için önerilen ön ekleri sağlamalıdır. Aşağıdaki "XAML Tasarım Aracı Desteği veya Genel Serileştirme için En İyi Yöntem" bölümüne bakın.

Ön ek genellikle XAML ad alanından gelen tüm serileştirilmiş öğelere uygulandığından, önekler için genel bir öneri kısa dizeler kullanmaktır. Ön ek dizesi uzunluğu, seri hale getirilmiş XAML çıkışının boyutu üzerinde belirgin bir etkiye sahip olabilir.

İstenen ön ek önceden karşılaşılan/seri hale getirilmiş başka bir XAML ad alanı tanımlayıcısı tarafından zaten kullanılıyorsa, davranış belirtilmez (davranış her bir XAML işlemci uygulamasına kadardır).

Çoğu durumda, yalnızca aynı XAML ad alanı için derlemeye en az bir tane XmlnsDefinitionAttribute uyguladıysanız uygularsınızXmlnsPrefixAttribute.

.NET Framework önceki sürümlerinde, bu sınıf WPF'ye özgü WindowsBase derlemesinde mevcutdu. .NET Framework 4'te System.Xaml XmlnsPrefixAttribute derlemesindedir. Daha fazla bilgi için bkz . WPF'den System.Xaml'e Geçirilen Türler.

XAML Tasarım Aracı Desteği veya Genel Serileştirme için En İyi Uygulama

Çerçeveniz veya kitaplığınız için çoğu kullanım örneğinde ilişkili XAML ad alanının varsayılan XAML ad alanı olmasını planlıyor olsanız bile, yine de XAML ad alanı için önerilen ön ek olarak boş olmayan bir dize belirtmeniz gerekir. Varsayılan XAML ad alanı bilgileri tek tek XAML dosyalarında ve XAML düğümü akışlarında taşınır. Varsayılan XAML ad alanı ve belirli bir XAML kaynağında tanımlanma şekli, kullanmadan XmlnsPrefixAttributebüyük/küçük harf serileştirme için kolayca kalıcı hale getirilebilir. Ancak, XmlnsPrefixAttribute XAML yazarının varsayılan XAML ad alanını başka bir şeyle eşlemeyi seçtiği durumlar için yararlıdır. Bu senaryoda, tasarım ortamına eklenmiş bir XAML metin düzenleyicisi, ilk XAML ad alanı xmlns eşlemesi için ipucu olarak kullanabilirXmlnsPrefixAttribute. Alternatif olarak tasarım ortamı, nesneleri araç kutusundan ve görsel tasarım yüzeyine sürükleme gibi tasarım metaforları için yedekleme XAML'sine tam zamanında eşlemeler ekleyebilir. Ayrıca, bir tasarımcının aynı anda birden çok XAML etkinleştirme çerçevesini destekleyebilecek olması ve çerçeveye özgü serileştirme yerine .NET Framework XAML Hizmetleri'ne dayalı ortak bir XAML serileştiricisi olması düşünülebilir. Bu senaryolar için bir XmlnsPrefixAttribute belirtilmesi, XAML'nin tasarım araçları arasında paylaşılması veya XAML düzenleyicileri ile işaretleme derleyicileri veya diğer serileştirme gibi diğer tüketiciler arasında gidiş dönüşe geçmesi durumunda türlerinizin XAML kullanımını daha taşınabilir ve sağlam hale getirmenize yardımcı olur.

Oluşturucular

XmlnsPrefixAttribute(String, String)

XmlnsPrefixAttribute sınıfının yeni bir örneğini başlatır.

Özellikler

Prefix

Bu öznitelikle ilişkili önerilen ön eki alır.

TypeId

Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır.

(Devralındığı yer: Attribute)
XmlNamespace

Bu öznitelikle ilişkili XAML ad alanı tanımlayıcısını alır.

Yöntemler

Equals(Object)

Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür.

(Devralındığı yer: Attribute)
GetHashCode()

Bu örneğe ilişkin karma kodu döndürür.

(Devralındığı yer: Attribute)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
IsDefaultAttribute()

Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir.

(Devralındığı yer: Attribute)
Match(Object)

Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür.

(Devralındığı yer: Attribute)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler.

(Devralındığı yer: Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Bir arabirimin tür bilgilerini almak için kullanılabilecek bir nesnenin tür bilgilerini alır.

(Devralındığı yer: Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1).

(Devralındığı yer: Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Bir nesne tarafından sunulan özelliklere ve yöntemlere erişim sağlar.

(Devralındığı yer: Attribute)

Şunlara uygulanır

Ayrıca bkz.