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
[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
Object
Exception
SystemException
XamlParseException
Öznitelikler
SerializableAttribute

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 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, ç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 () ve farklı bir derlemede (System.XamlSystem.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ız XamlParseException . Ancak, özel durum için işleme 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ı 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ç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, XamlParseException oluşturulduğunda, genellikle sayfa sınıfınız tarafından yapılan çağrı bağlamında InitializeComponent 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, 'ye bloklar InitializeComponentyerleş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

Name Description
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, Exception)

Belirtilen özel durum ileti dizesini XamlParseException ve iç özel durumu 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.
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 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.

Özellikler

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

Exception Geçerli özel duruma 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

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

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