XamlParseException Sınıf

Tanım

Ad Alanı:

System.Windows.Markup

Bütünleştirilmiş Kod:

PresentationFramework.dll

WPF XAML ayrıştırıcısından ayrıştırıcıya özgü özel durumlar için özel durum sınıfını temsil eder. Bu özel durum, .NET Framework 3.0 ve .NET Framework 3.5'ten XAML API veya WPF XAML ayrıştırıcı işlemlerinde veya XamlReader API'sini çağırarak WPF XAML ayrıştırıcısının belirli kullanımı için kullanılır.

public ref class XamlParseException : SystemException

public class XamlParseException : SystemException

type XamlParseException = class
    inherit SystemException

Public Class XamlParseException
Inherits SystemException

Devralma

Object

Exception

SystemException

XamlParseException

Açıklamalar

XamlParseException yalnızca WPF uygulamaları için XAML ayrıştırma ve yükleme işlemini gerçekleştiren WPF tarafından uygulanan XAML ayrıştırıcısı için kullanılır. Özel olarak, özel durum yalnızca bir uygulama .NET Framework 3.0 ve .NET Framework 3.5'i hedeflediğinde geçerlidir. Özel durum, çalışan bir WPF uygulamasının içinden XAML yüklemek için WPF tarafından uygulanan XAML ayrıştırıcısını çalıştıran API'lere yönelik çalışma zamanı çağrılarındaki kullanıcı kodundan da kaynaklanabilir (örneğin, XamlReader.Loadçağrısı).

.NET Framework 4 için, genellikle XAML işleme özel durumlarını bildiren XamlParseException özel durumu farklı bir ad alanında (System.Xaml) ve farklı bir derlemede (System.Xaml) tanımlanır.

WPF XAML ayrıştırıcısına eşdeğer bir yazı yazmadığınız veya .NET Framework 3.0 ve .NET Framework 3.5 hedeflemesi ile çalışmadığınız sürece, genellikle kendi kodunuzdan XamlParseException oluşturmazsınız. Ancak, özel durum için işleme bazen gereklidir. XAML ayrıştırma hatalarını engellemek isteyebileceğiniz uygulama senaryolarında, uygulama düzeyinde DispatcherUnhandledException olay işleyicisi, çalışma zamanı XamlParseExceptionişlemenin bir yoludur. Özel durumların gizlenip gizlenmeyeceği veya kullanıcı koduna aktarılmalarına izin verilip verilmeyeceği, uygulamanızı XAML'yi yükleme amacıyla nasıl tasarladığınıza ve uygulamanızın yüklediği XAML'ye atadığınız güven düzeyine bağlıdır. Daha fazla bilgi içinXAML'ye Genel Bakış (WPF) XAML Güvenlik Konuları veya "XAML Güvenliği" bölümüne bakın.

Bir uygulamanın sayfaları için, XamlParseException oluşturulduğunda, genellikle sayfa sınıfınız tarafından yapılan InitializeComponent çağrısı bağlamında olur. Bu, WPF uygulama modelinin sayfa başına düzeyde WPF XAML ayrıştırıcısı kullanımı için giriş noktasıdır. Bu nedenle başka bir olası işleme stratejisi, InitializeComponenttry/catch blokları yerleştirmektir. Ancak, bu teknik şablonlar, görsel tasarım yüzeyleri ve InitializeComponentbağlanan diğer oluşturulan kaynaklarla iyi tümleştirilmez.

Oluşturucular

XamlParseException()	XamlParseException sınıfının yeni bir örneğini başlatır.
XamlParseException(SerializationInfo, StreamingContext)	XamlParseException sınıfının yeni bir örneğini başlatır.
XamlParseException(String)	Belirtilen özel durum ileti dizesini kullanarak XamlParseException sınıfının yeni bir örneğini başlatır.
XamlParseException(String, Exception)	Belirtilen özel durum ileti dizesini ve iç özel durumu kullanarak XamlParseException sınıfının yeni bir örneğini başlatır.
XamlParseException(String, Int32, Int32)	Belirtilen özel durum iletisi dizesini ve belirtilen satır numarasını ve satırdaki konumu kullanarak XamlParseException sınıfının yeni bir örneğini başlatır.
XamlParseException(String, Int32, Int32, Exception)	Belirtilen özel durum iletisini, iç özel durumu, satır numarasını ve satırdaki konumu kullanarak XamlParseException sınıfının yeni bir örneğini başlatır.

Özellikler

BaseUri	Özel durum oluşturulduğunda temel URI bilgilerini alır.
Data	Özel durum hakkında kullanıcı tanımlı ek bilgiler sağlayan anahtar/değer çiftleri koleksiyonunu alır. (Devralındığı yer: Exception)
HelpLink	Bu özel durumla ilişkili yardım dosyasının bağlantısını alır veya ayarlar. (Devralındığı yer: Exception)
HResult	Belirli bir özel duruma atanan kodlanmış sayısal bir değer olan HRESULT değerini alır veya ayarlar. (Devralındığı yer: Exception)
InnerException	Geçerli özel duruma neden olan Exception örneğini alır. (Devralındığı yer: Exception)
KeyContext	Özel durumun oluştuğu sözlükteki öğenin anahtar değerini alır veya ayarlar.
LineNumber	Özel durumun oluştuğu satır numarasını alır.
LinePosition	Özel durumun oluştuğu satırdaki konumu alır.
Message	Geçerli özel durumu açıklayan bir ileti alır. (Devralındığı yer: Exception)
NameContext	Özel durumun oluştuğu nesnenin XAML adını alır veya ayarlar.
Source	Hataya neden olan uygulamanın veya nesnenin adını alır veya ayarlar. (Devralındığı yer: Exception)
StackTrace	Çağrı yığınındaki anlık çerçevelerin dize gösterimini alır. (Devralındığı yer: Exception)
TargetSite	Geçerli özel durumu oluşturan yöntemini alır. (Devralındığı yer: Exception)
UidContext	Özel durumun oluştuğu nesnenin x:Uid Yönergesi alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetBaseException()	Türetilmiş bir sınıfta geçersiz kılındığında, sonraki bir veya daha fazla özel durumun kök nedeni olan Exception döndürür. (Devralındığı yer: Exception)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)	Belirtilen SerializationInfo nesnesini doldurarak belirtilen nesneyi seri hale getirmek için gereken verileri alır.
GetType()	Geçerli örneğin çalışma zamanı türünü alır. (Devralındığı yer: Exception)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli özel durumun dize gösterimini oluşturur ve döndürür. (Devralındığı yer: Exception)

Ekinlikler

SerializeObjectState

Özel durum hakkında serileştirilmiş veriler içeren bir özel durum durumu nesnesi oluşturmak için bir özel durum seri hale getirildiğinde gerçekleşir. (Devralındığı yer: Exception)

Ayrıca bkz.

• XAML Hizmetleri