XmlnsPrefixAttribute Sınıf

Tanım

Ad Alanı:

System.Windows.Markup

Bütünleştirilmiş Kod:

System.Xaml.dll

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

Object

Attribute

XmlnsPrefixAttribute

Öznitelikler

AttributeUsageAttribute

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)

Ayrıca bkz.

• Özel türler ve kitaplıklar için XAML ile ilgili CLR öznitelikleri
• .NET XAML Hizmetleri ile kullanmak üzere özel türler tanımlama
• XAML Hizmetleri