XmlnsPrefixAttribute Sınıf

Tanım

Ad Alanı:
System.Windows.Markup
Bütünleştirilmiş Kod:
WindowsBase.dll
Bütünleştirilmiş Kod:
System.Xaml.dll

XAML dosyasında öğeler ve öznitelikler 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 grafiğinde bir şekilde korunmadığı veya bir çerçeve veya teknoloji tarafından başka bir şekilde depolanmadığı her durumda gerekli olabilir. Çerçeve, kendi derlemelerinden önerilen ön eki 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ımcısı 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, serileştirilmiş XAML çıkışının boyutu üzerinde belirgin bir etkiye sahip olabilir.

İstenen bir ö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 kadar).

Ç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'ün ö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ımcısı Desteği veya Genel Serileştirme için En İyi Yöntem

Ç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ı amaçlasanız bile, 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 nasıl tanımlandığı, kullanılmadan XmlnsPrefixAttributebüyük/küçük harf başına 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, bir tasarım ortamına katıştırılmış bir XAML metin düzenleyicisi, ilk XAML ad alanı xmlns eşlemesi için ipucu olarak kullanabilirXmlnsPrefixAttribute. Alternatif olarak bir tasarım ortamı, nesneleri bir 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 tasarım araçları arasında değiştirilirse 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çerse, türleriniz için XAML kullanımını daha taşınabilir ve sağlam hale getirmenize yardımcı olur.

Oluşturucular

Name Description
XmlnsPrefixAttribute(String, String)

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

Özellikler

Name Description
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

Name Description
Equals(Object)

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

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

Bu örneğin karma kodunu döndürür.

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

Geçerli örneğin Type 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 Objectbasit bir kopyasını oluşturur.

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

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

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

Name Description
_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 kullanıma sunulan özelliklere ve yöntemlere erişim sağlar.

(Devralındığı yer: Attribute)

Şunlara uygulanır

Ayrıca bkz.

  • Özel türler ve kitaplıklar için XAML ile ilgili CLR özniteliklerini
  • .NET XAML Hizmetleri
  • XAML Hizmetleri