XamlParseException Kelas

Definisi

Ruang nama:

System.Windows.Markup

Rakitan:

PresentationFramework.dll

Mewakili kelas pengecualian untuk pengecualian khusus pengurai dari pengurai WPF XAML. Pengecualian ini digunakan dalam operasi pengurai XAML API atau WPF XAML dari .NET Framework 3.0 dan .NET Framework 3.5, atau untuk penggunaan khusus pengurai WPF XAML dengan memanggil XamlReader API.

public ref class XamlParseException : SystemException

public class XamlParseException : SystemException

type XamlParseException = class
    inherit SystemException

Public Class XamlParseException
Inherits SystemException

Warisan

Object

Exception

SystemException

XamlParseException

Keterangan

XamlParseException hanya digunakan untuk pengurai XAML yang diimplementasikan WPF yang melakukan penguraian dan pemuatan XAML untuk aplikasi WPF. Secara khusus, pengecualian hanya relevan ketika aplikasi menargetkan .NET Framework 3.0 dan .NET Framework 3.5. Pengecualian juga dapat berasal dari kode pengguna dalam panggilan run-time ke API yang menghubungkan parser XAML yang diimplementasikan WPF untuk memuat XAML dari dalam aplikasi WPF yang sedang berjalan (misalnya, panggilan ke XamlReader.Load).

Untuk .NET Framework 4, XamlParseException pengecualian yang biasanya melaporkan pengecualian pemrosesan XAML didefinisikan dalam namespace layanan yang berbeda (System.Xaml) dan rakitan yang berbeda (System.Xaml).

Kecuali Anda menulis yang setara dengan pengurai WPF XAML atau bekerja dengan penargetan .NET Framework 3.0 dan .NET Framework 3.5, Anda umumnya tidak akan membuang XamlParseException dari kode Anda sendiri. Namun, penanganan untuk pengecualian terkadang diperlukan. Untuk skenario aplikasi, di mana Anda mungkin ingin menekan kesalahan penguraian XAML, penanganan DispatcherUnhandledException aktivitas di tingkat aplikasi adalah salah satu cara untuk menangani run-time XamlParseException. Apakah akan menekan pengecualian atau membiarkannya muncul ke kode pengguna tergantung pada cara Anda merancang aplikasi Anda untuk tujuan memuat XAML, dan tingkat kepercayaan yang Anda tetapkan ke XAML yang dimuat aplikasi Anda. Untuk informasi selengkapnya, lihat bagian Pertimbangan Keamanan XAML atau "Keamanan XAML" dari Gambaran Umum XAML (WPF).

Untuk halaman aplikasi, ketika XamlParseException dilemparkan, biasanya dalam konteks InitializeComponent panggilan yang dilakukan oleh kelas halaman Anda, yang merupakan titik masuk untuk penggunaan pengurai WPF XAML model aplikasi WPF di tingkat per halaman. Oleh karena itu strategi penanganan lain yang mungkin adalah menempatkan try/catch blok di InitializeComponent. Namun, teknik ini tidak berintegrasi dengan baik dengan templat, permukaan desain visual, dan sumber lain yang dihasilkan yang menghubungkan InitializeComponent.

Konstruktor

XamlParseException()	Menginisialisasi instans baru kelas XamlParseException.
XamlParseException(SerializationInfo, StreamingContext)	Menginisialisasi instans baru kelas XamlParseException.
XamlParseException(String)	Menginisialisasi instans XamlParseException baru kelas, menggunakan string pesan pengecualian yang ditentukan.
XamlParseException(String, Exception)	Menginisialisasi instans XamlParseException baru kelas, menggunakan string pesan pengecualian yang ditentukan dan pengecualian dalam.
XamlParseException(String, Int32, Int32)	Menginisialisasi instans XamlParseException baru kelas, menggunakan string pesan pengecualian yang ditentukan, dan nomor baris dan posisi yang ditentukan dalam baris.
XamlParseException(String, Int32, Int32, Exception)	Menginisialisasi instans XamlParseException baru kelas, menggunakan pesan pengecualian yang ditentukan, pengecualian dalam, nomor baris, dan posisi dalam baris.

Properti

BaseUri	Mendapatkan informasi URI dasar ketika pengecualian dilemparkan.
Data	Mendapatkan kumpulan pasangan kunci/nilai yang memberikan informasi tambahan yang ditentukan pengguna tentang pengecualian. (Diperoleh dari Exception)
HelpLink	Mendapatkan atau mengatur tautan ke file bantuan yang terkait dengan pengecualian ini. (Diperoleh dari Exception)
HResult	Mendapatkan atau menetapkan HRESULT, nilai numerik berkode yang ditetapkan ke pengecualian tertentu. (Diperoleh dari Exception)
InnerException	Mendapatkan instans Exception yang menyebabkan pengecualian saat ini. (Diperoleh dari Exception)
KeyContext	Mendapatkan atau mengatur nilai kunci item dalam kamus tempat pengecualian terjadi.
LineNumber	Mendapatkan nomor baris tempat pengecualian terjadi.
LinePosition	Mendapatkan posisi di baris tempat pengecualian terjadi.
Message	Mendapatkan pesan yang menjelaskan pengecualian saat ini. (Diperoleh dari Exception)
NameContext	Mendapatkan atau mengatur nama XAML objek tempat pengecualian terjadi.
Source	Get dan set nama aplikasi atau objek yang menyebabkan kesalahan. (Diperoleh dari Exception)
StackTrace	Mendapatkan representasi string dari bingkai langsung pada tumpukan panggilan. (Diperoleh dari Exception)
TargetSite	Mendapatkan metode yang melemparkan pengecualian saat ini. (Diperoleh dari Exception)
UidContext	Mendapatkan atau mengatur Arahan x:Uid dari objek tempat pengecualian terjadi.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetBaseException()	Ketika ditimpa di kelas turunan, mengembalikan Exception yang merupakan akar penyebab dari satu atau beberapa pengecualian berikutnya. (Diperoleh dari Exception)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetObjectData(SerializationInfo, StreamingContext)	Mendapatkan data yang diperlukan untuk membuat serial objek yang ditentukan dengan mengisi objek yang ditentukan SerializationInfo .
GetType()	Mendapatkan jenis runtime instans saat ini. (Diperoleh dari Exception)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Membuat dan mengembalikan representasi string dari pengecualian saat ini. (Diperoleh dari Exception)

Acara

SerializeObjectState

Terjadi ketika pengecualian diserialisasikan untuk membuat objek status pengecualian yang berisi data berseri tentang pengecualian. (Diperoleh dari Exception)

Lihat juga

• Layanan XAML