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ısı işlemlerinde veya API çağrılarak XamlReader 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 gerçekleştiren WPF tarafından uygulanan XAML ayrıştırıcısı için kullanılır. Özel durum, yalnızca bir uygulama 3.0 ve .NET Framework 3.5 .NET Framework 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ı oluşturan API'lere yönelik çalışma zamanı çağrılarındaki kullanıcı kodundan da kaynaklanabilir (örneğin, çağrısı XamlReader.Load).

.NET Framework 4 için genellikle XamlParseException XAML işleme özel durumlarını bildiren özel durum 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 oluşturmazsınızXamlParseException. Ancak, özel durumun işlenmesi bazen gereklidir. XAML ayrıştırma hatalarını engellemek isteyebileceğiniz uygulama senaryolarında, uygulama düzeyinde bir DispatcherUnhandledException olay işleyicisi çalışma zamanını XamlParseExceptionişlemenin bir yoludur. Özel durumların gizlenip gizlenmeyeceği veya kullanıcı kodunda ortaya çıkması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çin XAML'ye Genel Bakış (WPF) öğesinin XAML Güvenliğiyle İlgili Dikkat Edilmesi Gerekenler veya "XAML Güvenliği" bölümüne bakın.

Bir uygulamanın sayfaları için, oluşturulurken XamlParseException genellikle sayfa sınıfınız tarafından yapılan çağrı bağlamındadır InitializeComponent . 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, blokları 'InitializeComponentye yerleştirmektirtry/catch. Ancak, bu teknik şablonlar, görsel tasarım yüzeyleri ve bağlantısı InitializeComponentolan 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 XamlParseException kullanarak sınıfının yeni bir örneğini başlatır.
XamlParseException(String, Exception)	Belirtilen özel durum iletisi dizesini XamlParseException ve iç özel durumu kullanarak sınıfının yeni bir örneğini başlatır.
XamlParseException(String, Int32, Int32)	Belirtilen özel durum iletisi dizesini XamlParseException ve belirtilen satır numarasını ve satırdaki konumu kullanarak 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 sınıfın yeni bir örneğini XamlParseException 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 bir anahtar/değer çifti koleksiyonu 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 Exception neden olan örneği 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önergesini 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 değerini döndürür Exception . (Devralındığı yer: Exception)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)	Belirtilen nesneyi doldurarak SerializationInfo 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 Objectöğesinin sığ 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

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

Ayrıca bkz.

• XAML Hizmetleri