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 используется только для средства синтаксического анализа 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) |
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по