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 : SystemExceptionpublic class XamlParseException : SystemException[<System.Serializable>]
type XamlParseException = class
inherit SystemExceptiontype XamlParseException = class
inherit SystemExceptionPublic Class XamlParseException
Inherits SystemException- Наследование
- Атрибуты
Комментарии
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) |
