XamlParseException Klasa

Definicja

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

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
Dziedziczenie
XamlParseException
Atrybuty

Uwagi

XamlParseException Jest używany tylko dla analizatora XAML zaimplementowanego 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 .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 zaimplementowany przez platformę WPF w celu załadowania kodu XAML z uruchomionej aplikacji WPF (na przykład wywołań do XamlReader.Loadmetody ).

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

Jeśli nie piszesz odpowiednika analizatora XAML WPF lub pracujesz z .NET Framework 3.0 i .NET Framework 3.5 określania wartości docelowej, zazwyczaj nie będzie zwracany 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, DispatcherUnhandledException procedura obsługi zdarzeń na poziomie aplikacji jest jednym ze sposobów obsługi środowiska uruchomieniowego XamlParseException. 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 sekcję "Zabezpieczenia XAML" w temacie XAML Overview (WPF) (Omówienie języka XAML (WPF).

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

Konstruktory

XamlParseException()

Inicjuje nowe wystąpienie klasy XamlParseException.

XamlParseException(SerializationInfo, StreamingContext)

Inicjuje nowe wystąpienie klasy XamlParseException.

XamlParseException(String)

Inicjuje XamlParseException nowe wystąpienie klasy przy użyciu określonego ciągu komunikatu o wyjątku.

XamlParseException(String, Exception)

Inicjuje XamlParseException nowe wystąpienie klasy przy użyciu określonego ciągu komunikatu wyjątku i wyjątku wewnętrznego.

XamlParseException(String, Int32, Int32)

Inicjuje XamlParseException nowe wystąpienie klasy przy użyciu określonego ciągu komunikatu o wyjątku oraz określony numer wiersza i położenie w wierszu.

XamlParseException(String, Int32, Int32, Exception)

Inicjuje XamlParseException nowe wystąpienie klasy 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

Exception Pobiera wystąpienie, 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 dyrektywę x:Uid obiektu, w którym wystąpił wyjątek.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetBaseException()

Po przesłonięciu w klasie pochodnej funkcja zwraca Exception 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 SerializationInfo obiektu.

GetType()

Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia.

(Odziedziczone po Exception)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.

(Odziedziczone po Exception)

Zdarzenia

SerializeObjectState
Przestarzałe.

Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku, który zawiera serializowane dane dotyczące wyjątku.

(Odziedziczone po Exception)

Dotyczy

Zobacz też