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 parser WPF XAML tertentu dengan memanggil API XamlReader.

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, pengecualian XamlParseException 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 melempar XamlParseException dari kode Anda sendiri. Namun, penanganan untuk pengecualian terkadang diperlukan. Untuk skenario aplikasi, di mana Anda mungkin ingin menekan kesalahan penguraian XAML, penanganan aktivitas DispatcherUnhandledException 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 Pertimbangan Keamanan XAML atau bagian "Keamanan XAML"Gambaran Umum XAML (WPF).

Untuk halaman aplikasi, ketika XamlParseException dilemparkan, biasanya dalam konteks panggilan InitializeComponent 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 blok try/catch 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 baru kelas XamlParseException, menggunakan string pesan pengecualian yang ditentukan.
XamlParseException(String, Exception)	Menginisialisasi instans baru kelas XamlParseException, menggunakan string pesan pengecualian dan pengecualian dalam yang ditentukan.
XamlParseException(String, Int32, Int32)	Menginisialisasi instans baru kelas XamlParseException, menggunakan string pesan pengecualian yang ditentukan, dan nomor baris dan posisi yang ditentukan dalam baris.
XamlParseException(String, Int32, Int32, Exception)	Menginisialisasi instans baru kelas XamlParseException, 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 mengatur 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	Mendapatkan atau mengatur 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 direktif x:Uid objek tempat pengecualian terjadi.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetBaseException()	Saat ditimpa dalam 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 menserialisasikan objek yang ditentukan dengan mengisi objek SerializationInfo yang ditentukan.
GetType()	Mendapatkan jenis runtime instans saat ini. (Diperoleh dari Exception)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (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