XamlParseException Класс

Определение

Представляет класс исключений для исключений, характерных для средства синтаксического анализа WPF XAML. Это исключение используется в операциях синтаксического анализа XAML ИЛИ XAML WPF из .NET Framework 3.0 и .NET Framework 3.5 или для конкретного использования средства синтаксического анализа XAML WPF путем вызова 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
Наследование
XamlParseException
Атрибуты

Комментарии

XamlParseException используется только для средства синтаксического анализа XAML, реализующего синтаксический анализ и загрузку XAML для приложений WPF. В частности, исключение имеет значение, только если приложение предназначено для .NET Framework 3.0 и .NET Framework 3.5. Исключение также может возникать из пользовательского кода во время выполнения вызовов API, которые перехватывает средство синтаксического анализа XAML, реализованного WPF, для загрузки XAML из работающего приложения WPF (например, вызовы XamlReader.Load).

Для .NET Framework 4 XamlParseException исключение, которое обычно сообщает об исключениях обработки XAML, определяется в другом пространстве имен (System.Xaml) и другой сборке (System.Xaml).

Если вы не пишете эквивалент средства синтаксического анализа XAML WPF или работаете с .NET Framework 3.0 и .NET Framework 3.5, обычно вы не будете создавать XamlParseException из собственного кода. Однако иногда требуется обработка исключения. В сценариях приложений, где может потребоваться отключить ошибки синтаксического анализа XAML, обработчик событий DispatcherUnhandledException на уровне приложения является одним из способов обработки XamlParseExceptionво время выполнения. Независимо от того, следует ли подавлять исключения или разрешать им отображаться в пользовательском коде, зависит от того, как вы разрабатываете приложение для загрузки XAML, а также уровень доверия, который вы назначаете xaml для загрузки приложения. Дополнительные сведения см. в разделе Вопросы безопасности XAML или "Безопасность XAML" обзоре XAML (WPF).

Для страниц приложения при возникновении XamlParseException обычно в контексте вызова InitializeComponent класса страницы, который является точкой входа для использования средства синтаксического анализа XAML WPF на уровне страницы. Поэтому другая возможная стратегия обработки заключается в том, чтобы поместить блоки try/catch в InitializeComponent. Однако этот метод не интегрируется хорошо с шаблонами, поверхностями визуального проектирования и другими созданными источниками, которые подключены InitializeComponent.

Конструкторы

XamlParseException()

Инициализирует новый экземпляр класса XamlParseException.

XamlParseException(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса XamlParseException.

XamlParseException(String)

Инициализирует новый экземпляр класса XamlParseException с помощью указанной строки сообщения об исключении.

XamlParseException(String, Exception)

Инициализирует новый экземпляр класса XamlParseException, используя указанную строку сообщения об исключении и внутреннее исключение.

XamlParseException(String, Int32, Int32)

Инициализирует новый экземпляр класса XamlParseException, используя указанную строку сообщения об исключении, а также указанный номер строки и позицию в строке.

XamlParseException(String, Int32, Int32, Exception)

Инициализирует новый экземпляр класса XamlParseException, используя указанное сообщение об исключении, внутреннее исключение, номер строки и позицию в строке.

Свойства

BaseUri

Возвращает базовые сведения URI при возникновении исключения.

Data

Возвращает коллекцию пар "ключ-значение", которые предоставляют дополнительные пользовательские сведения об исключении.

(Унаследовано от Exception)
HelpLink

Возвращает или задает ссылку на файл справки, связанный с этим исключением.

(Унаследовано от Exception)
HResult

Возвращает или задает HRESULT, закодированное числовое значение, назначенное определенному исключению.

(Унаследовано от Exception)
InnerException

Возвращает экземпляр Exception, вызвавшего текущее исключение.

(Унаследовано от Exception)
KeyContext

Возвращает или задает ключевое значение элемента в словаре, в котором произошло исключение.

LineNumber

Возвращает номер строки, в которой произошло исключение.

LinePosition

Возвращает позицию в строке, в которой произошло исключение.

Message

Возвращает сообщение, описывающее текущее исключение.

(Унаследовано от Exception)
NameContext

Возвращает или задает имя XAML объекта, в котором произошло исключение.

Source

Возвращает или задает имя приложения или объекта, вызывающего ошибку.

(Унаследовано от Exception)
StackTrace

Возвращает строковое представление непосредственных кадров в стеке вызовов.

(Унаследовано от Exception)
TargetSite

Возвращает метод, который вызывает текущее исключение.

(Унаследовано от Exception)
UidContext

Возвращает или задает директиву x:Uid объекта, в котором произошло исключение.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetBaseException()

При переопределении в производном классе возвращает Exception, которая является основной причиной одного или нескольких последующих исключений.

(Унаследовано от Exception)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)

Возвращает данные, необходимые для сериализации указанного объекта, заполняя указанный объект SerializationInfo.

GetType()

Возвращает тип среды выполнения текущего экземпляра.

(Унаследовано от Exception)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
ToString()

Создает и возвращает строковое представление текущего исключения.

(Унаследовано от Exception)

События

SerializeObjectState
Устаревшие..

Происходит при сериализации исключения для создания объекта состояния исключения, содержащего сериализованные данные об исключении.

(Унаследовано от Exception)

Применяется к

См. также раздел