XamlParseException Класс

Определение

Представляет класс исключений для связанных с синтаксическим анализатором исключений из синтаксического анализатора XAML WPF. Это исключение используется в операциях синтаксического анализатора API 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, реализованного в WPF, который выполняет синтаксический анализ и загрузку XAML для приложений WPF. В частности, исключение применимо только в том случае, если приложение предназначено для платформа .NET Framework 3.0 и платформа .NET Framework 3.5. Исключение также может возникать из пользовательского кода во время выполнения вызовов API, которые подключили реализованное в WPF средство синтаксического анализа XAML для загрузки XAML из работающего приложения WPF (например, вызовы ).XamlReader.Load

Для платформа .NET Framework 4 исключение, которое обычно сообщает об исключениях обработки XAML, XamlParseException определяется в другом пространстве имен (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 вызова класса страницы, который является точкой входа для использования моделью приложения WPF средства синтаксического анализа 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 Directive объекта, где произошло исключение.

Методы

Equals(Object)

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

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

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

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

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

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

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

GetType()

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

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

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

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

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

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

События

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

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

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

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

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