XamlParseException Sınıf

Tanım

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
[System.Serializable]
public class XamlParseException : SystemException
public class XamlParseException : SystemException
[<System.Serializable>]
type XamlParseException = class
    inherit SystemException
type XamlParseException = class
    inherit SystemException
Public Class XamlParseException
Inherits SystemException
Devralma
XamlParseException
Öznitelikler

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
Geçersiz.

Ö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)

Şunlara uygulanır

Ayrıca bkz.