XamlParseException Klasa

Definicja

Przestrzeń nazw:

System.Windows.Markup

Zestaw:

PresentationFramework.dll

Reprezentuje klasę wyjątku dla wyjątków specyficznych dla analizatora z analizatora XAML WPF. Ten wyjątek jest używany w przypadku operacji analizatora XAML lub interfejsu API XAML WPF z programów .NET Framework 3.0 i .NET Framework 3.5 lub do określonego użycia analizatora XAML WPF przez wywołanie interfejsu API XamlReader.

public ref class XamlParseException : SystemException

public class XamlParseException : SystemException

type XamlParseException = class
    inherit SystemException

Public Class XamlParseException
Inherits SystemException

Dziedziczenie

Object

Exception

SystemException

XamlParseException

Uwagi

XamlParseException jest używana tylko w przypadku analizatora XAML zaimplementowanego w WPF, który wykonuje analizowanie i ładowanie XAML dla aplikacji WPF. W szczególności wyjątek jest istotny tylko wtedy, gdy aplikacja jest przeznaczona dla programów .NET Framework 3.0 i .NET Framework 3.5. Wyjątek może również pochodzić z kodu użytkownika w wywołaniach czasu wykonywania do interfejsów API, które podłączają analizator XAML implementowany przez platformę WPF w celu załadowania kodu XAML z uruchomionej aplikacji WPF (na przykład wywołań do XamlReader.Load).

W przypadku programu .NET Framework 4 wyjątek XamlParseException, który zwykle zgłasza wyjątki przetwarzania XAML, jest definiowany w innej przestrzeni nazw (System.Xaml) i innym zestawie (System.Xaml).

Jeśli nie piszesz odpowiednika analizatora XAML WPF lub pracy z platformami .NET Framework 3.0 i .NET Framework 3.5, zazwyczaj nie będzie zgłaszać XamlParseException z własnego kodu. Jednak obsługa wyjątku jest czasami konieczna. W scenariuszach aplikacji, w których można pominąć błędy analizy XAML, program obsługi zdarzeń DispatcherUnhandledException na poziomie aplikacji jest jednym ze sposobów obsługi XamlParseExceptionczasu wykonywania. To, czy pomijać wyjątki, czy zezwalać im na wyświetlanie kodu użytkownika, zależy od sposobu projektowania aplikacji na potrzeby ładowania kodu XAML oraz poziomu zaufania przypisanego do kodu XAML ładowanego przez aplikację. Aby uzyskać więcej informacji, zobacz zagadnienia dotyczące zabezpieczeń XAML lub "Zabezpieczenia XAML" XAML Overview (WPF).

W przypadku stron aplikacji, gdy jest zgłaszana XamlParseException, zwykle jest to w kontekście wywołania InitializeComponent wykonanego przez klasę strony, który jest punktem wejścia dla użycia modelu aplikacji WPF analizatora XAML WPF na poziomie poszczególnych stron. W związku z tym kolejną możliwą strategią obsługi jest umieszczenie try/catch bloków w InitializeComponent. Jednak ta technika nie integruje się dobrze z szablonami, powierzchniami projektowymi wizualizacji i innymi wygenerowanymi źródłami, które podłączą InitializeComponent.

Konstruktory

XamlParseException()	Inicjuje nowe wystąpienie klasy XamlParseException.
XamlParseException(SerializationInfo, StreamingContext)	Inicjuje nowe wystąpienie klasy XamlParseException.
XamlParseException(String)	Inicjuje nowe wystąpienie klasy XamlParseException przy użyciu określonego ciągu komunikatu wyjątku.
XamlParseException(String, Exception)	Inicjuje nowe wystąpienie klasy XamlParseException przy użyciu określonego ciągu komunikatu wyjątku i wyjątku wewnętrznego.
XamlParseException(String, Int32, Int32)	Inicjuje nowe wystąpienie klasy XamlParseException przy użyciu określonego ciągu komunikatu wyjątku oraz określonego numeru wiersza i pozycji w wierszu.
XamlParseException(String, Int32, Int32, Exception)	Inicjuje nowe wystąpienie klasy XamlParseException przy użyciu określonego komunikatu wyjątku, wyjątku wewnętrznego, numeru wiersza i pozycji w wierszu.

Właściwości

BaseUri	Pobiera podstawowe informacje o identyfikatorze URI po wystąpieniu wyjątku.
Data	Pobiera kolekcję par klucz/wartość, które zapewniają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku. (Odziedziczone po Exception)
HelpLink	Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem. (Odziedziczone po Exception)
HResult	Pobiera lub ustawia HRESULT, zakodowaną wartość liczbową przypisaną do określonego wyjątku. (Odziedziczone po Exception)
InnerException	Pobiera wystąpienie Exception, które spowodowało bieżący wyjątek. (Odziedziczone po Exception)
KeyContext	Pobiera lub ustawia wartość klucza elementu w słowniku, w którym wystąpił wyjątek.
LineNumber	Pobiera numer wiersza, w którym wystąpił wyjątek.
LinePosition	Pobiera pozycję w wierszu, w którym wystąpił wyjątek.
Message	Pobiera komunikat opisujący bieżący wyjątek. (Odziedziczone po Exception)
NameContext	Pobiera lub ustawia nazwę XAML obiektu, w którym wystąpił wyjątek.
Source	Pobiera lub ustawia nazwę aplikacji lub obiektu, który powoduje błąd. (Odziedziczone po Exception)
StackTrace	Pobiera reprezentację ciągu natychmiastowych ramek na stosie wywołań. (Odziedziczone po Exception)
TargetSite	Pobiera metodę, która zgłasza bieżący wyjątek. (Odziedziczone po Exception)
UidContext	Pobiera lub ustawia x:Uid Dyrektywy obiektu, w którym wystąpił wyjątek.

Metody

Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetBaseException()	Po zastąpieniu w klasie pochodnej zwraca Exception, która jest główną przyczyną co najmniej jednego kolejnego wyjątku. (Odziedziczone po Exception)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)	Pobiera dane wymagane do serializacji określonego obiektu przez wypełnienie określonego obiektu SerializationInfo.
GetType()	Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia. (Odziedziczone po Exception)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Tworzy i zwraca reprezentację ciągu bieżącego wyjątku. (Odziedziczone po Exception)

Zdarzenia

SerializeObjectState

Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku zawierającego serializowane dane dotyczące wyjątku. (Odziedziczone po Exception)

Zobacz też

• usług XAML