Udostępnij za pośrednictwem


XamlParseException Klasa

Definicja

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
[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ż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
Przestarzałe.

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)

Dotyczy

Zobacz też

  • usług XAML