Xaml Parse Exception Класс
Определение
Представляет класс исключений для связанных с синтаксическим анализатором исключений из синтаксического анализатора XAML WPF. Represents the exception class for parser-specific exceptions from a WPF XAML parser. Это исключение используется в операциях синтаксического анализатора API XAML или XAML WPF из платформ .NET Framework 3.0 и .NET Framework 3.5, а также для выполнения специальных задач синтаксического анализатора XAML WPF путем вызова API XamlReader. This exception is used in XAML API or WPF XAML parser operations from .NET Framework 3.0 and .NET Framework 3.5, or for specific use of the WPF XAML parser by calling XamlReader API.
Комментарии
XamlParseException используется только для средства синтаксического анализа XAML, реализованного в WPF, которое выполняет синтаксический анализ и загрузку XAML для приложений WPF. XamlParseException is used only for the WPF-implemented XAML parser that performs the XAML parsing and loading for WPF applications. В частности, исключение уместно, только если приложение предназначено для платформа .NET Framework 3,0 и платформа .NET Framework 3,5. Specifically, the exception is only relevant when an application targets .NET Framework 3.0 and .NET Framework 3.5. Исключение также может исходить из пользовательского кода во время выполнения вызовов к API-интерфейсам, которые применяют средство синтаксического анализа XAML, реализованное в WPF, для загрузки XAML из выполняемого приложения WPF (например, вызовы метода XamlReader.Load ). The exception can also originate from user code in run-time calls to APIs that hook up the WPF-implemented XAML parser to load XAML from within a running WPF application (for example, calls to XamlReader.Load).
Для платформа .NET Framework 4 XamlParseException исключение, которое обычно сообщает об исключениях обработки XAML, определяется в другом пространстве имен ( System.Xaml ) и в другой сборке (System. XAML). For .NET Framework 4, the XamlParseException exception that typically reports XAML processing exceptions is defined in a different namespace (System.Xaml) and a different assembly (System.Xaml).
Если вы не пишете эквивалентом средства синтаксического анализатора XAML WPF или работаете с платформа .NET Framework 3,0 и платформа .NET Framework 3,5, то обычно не будет создаваться XamlParseException из собственного кода. Unless you are writing an equivalent to the WPF XAML parser or working with .NET Framework 3.0 and .NET Framework 3.5 targeting, you generally will not throw XamlParseException from your own code. Однако иногда требуется обработка исключения. However, handling for the exception is sometimes necessary. Для сценариев приложений, в которых может потребоваться подавлять ошибки синтаксического анализа XAML, Dispatcher UnhandledException обработчик событий на уровне приложения является одним из способов обработки времени выполнения XamlParseException . For application scenarios, where you may want to suppress XAML parse errors, a Dispatcher UnhandledException event handler at the application level is one way to handle a run-time XamlParseException. Следует ли отключать исключения или предоставлять пользователям пользовательский код, зависит от того, как вы разрабатываете приложение для загрузки XAML, и уровень доверия, назначаемый приложению XAML, которое загружает приложение. Whether to suppress exceptions or let them surface to user code depends on how you design your application for purposes of loading XAML, and the trust level that you assign to the XAML your application loads. Дополнительные сведения см. в разделах вопросы безопасности XAML или раздел «безопасность XAML» в разделе Общие сведения о XAML (WPF). For more information, see XAML Security Considerations or «XAML Security» section of XAML Overview (WPF).
Для страниц приложения, когда XamlParseException возникает исключение, оно обычно находится в контексте InitializeComponent вызова, сделанного классом страницы, который является точкой входа для модели приложения WPF использование средства синтаксического анализа XAML WPF на уровне отдельных страниц. For pages of an application, when the XamlParseException is thrown, it is usually in the context of the InitializeComponent call made by your page class, which is the entry point for the WPF application model’s usage of the WPF XAML parser at the per-page level. Поэтому еще одна возможная стратегия обработки заключается в помещении try/catch блоков в InitializeComponent . Therefore another possible handling strategy is to place try/catch blocks in InitializeComponent . Однако этот метод не интегрируется с шаблонами, областями визуального проектирования и другими созданными источниками, которые присоединяются InitializeComponent . However, this technique does not integrate well with templates, visual design surfaces and other generated sources that hook up InitializeComponent .
Конструкторы
Инициализирует новый экземпляр класса XamlParseException. Initializes a new instance of the XamlParseException class.
Инициализирует новый экземпляр класса XamlParseException. Initializes a new instance of the XamlParseException class.
Инициализирует новый экземпляр класса XamlParseException, используя указанную строку сообщения об исключении. Initializes a new instance of the XamlParseException class, using the specified exception message string.
Инициализирует новый экземпляр класса XamlParseException, используя указанную строку сообщения об исключении и внутреннее исключение. Initializes a new instance of the XamlParseException class, using the specified exception message string and inner exception.
Инициализирует новый экземпляр класса XamlParseException, используя указанную строку сообщения об исключении, указанный номер строки и позицию в строке. Initializes a new instance of the XamlParseException class, using the specified exception message string, and the specified line number and position in the line.
Инициализирует новый экземпляр класса XamlParseException, используя указанное сообщение об исключении, внутреннее исключение, номер строки и позицию в строке. Initializes a new instance of the XamlParseException class, using the specified exception message, inner exception, line number, and position in the line.
Свойства
Получает информацию о базовом URI, когда возникает исключение. Gets base URI information when the exception is thrown.
Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении. Gets a collection of key/value pairs that provide additional user-defined information about the exception.
(Унаследовано от Exception)
Получает или задает ссылку на файл справки, связанный с этим исключением. Gets or sets a link to the help file associated with this exception.
(Унаследовано от Exception)
Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению. Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.
(Унаследовано от Exception)
Возвращает экземпляр класса Exception, который вызвал текущее исключение. Gets the Exception instance that caused the current exception.
(Унаследовано от Exception)
Получает или задает ключевое значение элемента в словаре, где произошло исключение. Gets or sets the key value of the item in a dictionary where the exception occurred.
Получает номер строки, где произошло исключение. Gets the line number where the exception occurred.
Возвращает позицию в строке, в которой возникло исключение. Gets the position in the line where the exception occurred.
Возвращает сообщение, описывающее текущее исключение. Gets a message that describes the current exception.
(Унаследовано от Exception)
Получает или задает XAML-имя объекта, где произошло исключение. Gets or sets the XAML name of the object where the exception occurred.
Возвращает или задает имя приложения или объекта, вызывавшего ошибку. Gets or sets the name of the application or the object that causes the error.
(Унаследовано от Exception)
Получает строковое представление непосредственных кадров в стеке вызова. Gets a string representation of the immediate frames on the call stack.
(Унаследовано от Exception)
Возвращает метод, создавший текущее исключение. Gets the method that throws the current exception.
(Унаследовано от Exception)
Возвращает или задает x:Uid Directive объекта, где произошло исключение. Gets or sets the x:Uid Directive of the object where the exception occurred.
Методы
Определяет, равен ли указанный объект текущему объекту. Determines whether the specified object is equal to the current object.
(Унаследовано от Object)
При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений. When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.
(Унаследовано от Exception)
Служит хэш-функцией по умолчанию. Serves as the default hash function.
(Унаследовано от Object)
Получает данные, необходимые для сериализации заданного объекта путем заполнения заданного объекта SerializationInfo. Gets the data that is required to serialize the specified object by populating the specified SerializationInfo object.
Возвращает тип среды выполнения текущего экземпляра. Gets the runtime type of the current instance.
(Унаследовано от Exception)
Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.
(Унаследовано от Object)
Создает и возвращает строковое представление текущего исключения. Creates and returns a string representation of the current exception.
(Унаследовано от Exception)
События
Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении. Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.
System. Windows. Markup Пространство имен
Предоставляет типы, поддерживающие XAML. Provides types to support XAML. Некоторые из этих типов расположены в сборках WPF и относятся к сценариям WPF, в которых используется XAML. Some of these types are located in WPF assemblies and are specific to WPF scenarios that involve XAML. Другие типы этого пространства имен обеспечивают общую поддержку служб XAML платформы .NET, и для них не требуются ссылки на сборки WPF. Other types in this namespace provide support for .NET XAML Services in general, and don’t require referencing WPF assemblies.
Классы
Указывает типы для устаревших отчетов по характеристикам расширения разметки XAML. Notates types for legacy reporting of XAML markup extension characteristics.
Указывает, что свойство или тип должны обрабатываться как свойство или тип окружения. Specifies that a property or type should be treated as ambient. Концепция окружения относится к тому, как обработчики XAML определяют владельцев типов членов. The ambient concept relates to how XAML processors determine type owners of members.
Реализует поддержку x:Array для служб XAML .NET. Implements x:Array support for .NET XAML Services.
Реализовывает преобразователь типов для объектов ComponentResourceKey, у которых намеренно нет возможности преобразования. Implements a type converter for ComponentResourceKey objects, which deliberately have no type conversion pathways. Преобразователь типов задает данное поведение и предоставляет отчет о нем. The type converter enforces and reports that behavior.
Указывает, что объект может быть инициализирован с помощью синтаксиса конструктора, не являющегося конструктором без параметров, и что информация о конструкции предоставляется свойством указанного имени. Specifies that an object can be initialized by using a non-parameterless constructor syntax, and that a property of the specified name supplies construction information. Эта информация предназначена главным образом для сериализации XAML. This information is primarily for XAML serialization.
Указывает, какое свойство типа является свойством содержимого XAML. Indicates which property of a type is the XAML content property. Обработчик XAML использует эти сведения при обработке дочерних элементов XAML представлений XAML типа с атрибутом. A XAML processor uses this information when processing XAML child elements of XAML representations of the attributed type.
Указывает один или несколько типов для типа связанной коллекции, которая будет использоваться как оболочка для внешнего содержимого. Specifies one or more types on the associated collection type that will be used to wrap foreign content.
Преобразует экземпляры String в экземпляры DateTime и наоборот. Converts instances of String to and from instances of DateTime.
Преобразует из строки в объект DependencyProperty. Converts from a string to a DependencyProperty object.
Указывает, что свойство с атрибутом зависит от значения другого свойства. Indicates that the attributed property is dependent on the value of another property.
Задает для свойства флаги сериализации. Specifies the serialization flags for a property.
Задает свойство связанного класса, которое предоставляет значение неявного ключа. Specifies a property of the associated class that provides the implicit key value. Неявные ключи используются для ключей, а не явных атрибутов x:Key , определенных в XAML для элемента в коллекциях IDictionary. Implicit keys are used for keys rather than explicit x:Key attributes defined in XAML for an item in IDictionary collections.
Преобразует строковое имя обработчика переключателя события в представление делегата. Converts the string name of an event setter handler to a delegate representation.
Абстрактный класс, внутренне используемый компилятором WPF XAML для поддержки использования внутренних типов. Abstract class used internally by the WPF XAML compiler to support the use of internal types.
Предоставляет базовый класс для реализаций расширений разметки XAML, которые могут поддерживаться службами XAML платформы .NET и другими средствами чтения и записи XAML. Provides a base class for XAML markup extension implementations that can be supported by .NET XAML Services and other XAML readers and XAML writers.
Сообщает символы скобок, которые может возвращать расширение разметки. Reports the bracket characters that a markup extension can return.
Сообщает тип, который может возвращать расширение разметки. Reports the type that a markup extension can return.
Предоставляет базовый класс, используемый для методики разметки, предназначенной для определения членов класса в декларативной XAML-разметке. Provides the base class that is used for a markup technique of defining members of a class in declarative XAML.
Предоставляет преобразование типов для преобразования строкового имени в ссылку на объект с этим именем или для возврата имени объекта из графа объекта. Provides type conversion to convert a string name into an object reference to the object with that name, or to return the name of an object from the object graph.
Задает свойство связанного класса, которое предоставляет значение области имен XAML. Specifies a property of the associated class that provides the XAML namescope value.
Предоставляет информацию, которую класс XamlTypeMapper использует для сопоставления пространства имен XML, пространства имен CLR и сборки, содержащей подходящие типы для данного пространства имен CLR. Provides information that the XamlTypeMapper uses for mapping between an XML namespace, a CLR namespace, and the assembly that contains the relevant types for that CLR namespace.
Реализует расширение разметки XAML для возврата пустого объекта, который можно использовать для явного задания значений NULL в XAML. Implements a XAML markup extension in order to return a null object, which you can use to explicitly set values to null in XAML.
Предоставляет контекстную информацию, необходимую анализатору XAML. Provides context information required by a XAML parser.
Поддерживает методику разметки, используемую для определения свойств класса в декларативной XAML-разметке. Supports a markup technique of defining properties of a class in declarative XAML.
Реализует расширение разметки
Преобразует экземпляры ResourceReferenceExpression в иные типы и обратно. Converts instances of ResourceReferenceExpression to and from other types.
Представляет атрибут уровня сборки, используемый для определения значения свойства RootNamespace в файле проекта Visual Studio. Represents an assembly level attribute that is used to identify the value of the RootNamespace property in a Visual Studio project file.
Преобразует объект RoutedEvent из строки. Converts a RoutedEvent object from a string.
Представляет атрибут уровня типа, который сообщает, какое свойство типа сопоставляется с атрибутом XAML x:Name. Represents a type-level attribute that reports which property of the type maps to the XAML x:Name attribute.
Предоставляет реализацию для интерфейса IServiceProvider с методами, позволяющими добавлять службы. Provides an implementation for the IServiceProvider interface with methods that enable adding services.
Предоставляет аналогичное поведение преобразования для типов Setter, Trigger и Condition, обрабатывающих значения DependencyProperty. Provides type conversion analogous behavior for Setter, Trigger and Condition types that deal with DependencyProperty values. Преобразователь поддерживает только ConvertFrom . This converter only supports ConvertFrom .
Реализует расширение разметки, которое возвращает ссылки на статические поля и свойства. Implements a markup extension that returns static field and property references.
Реализовывает преобразователь типов для объектов TemplateKey, у которых намеренно нет возможности преобразования. Implements a type converter for TemplateKey objects, which deliberately have no type conversion pathways. Преобразователь типов задает данное поведение и предоставляет отчет о нем. The type converter enforces and reports that behavior.
Указывает обработчикам XAML, что пробелы вокруг элементов типа в разметке должны быть сокращены при сериализации. Indicates to XAML processors that the whitespace surrounding elements of the type in markup should be trimmed when serializing.
Реализует расширение разметки, возвращающее Type на основе входной строки. Implements a markup extension that returns a Type based on a string input.
Указывает свойство CLR класса, предоставляющего значение x:Uid Directive. Indicates the CLR property of a class that provides the x:Uid Directive value.
Указывает, строится ли этот тип сверху вниз в ходе создания графа объекта XAML. Indicates whether this type is built top-down during XAML object graph creation.
Абстрактный класс, который определяет поведение преобразования для сериализации из представления объекта. Abstract class that defines conversion behavior for serialization from an object representation.
Идентифицирует класс ValueSerializer, который тип или свойство должны использовать при сериализации. Identifies the ValueSerializer class that a type or property should use when it is serialized.
Указывает, что тип коллекции должен обрабатываться обработчиком XAML как тип со значащими пробелами. Indicates that a collection type should be processed as being whitespace significant by a XAML processor.
Указывает, что классу или свойству соответствует использование отложенной загрузки для XAML (в частности, поведение шаблона), и сообщает о классе, включающем задержку, и о его типе назначения/содержимого. Indicates that a class or property has a deferred load usage for XAML (such as a template behavior), and reports the class that enables the deferring behavior and its destination/content type.
Предоставляет службы для сериализации XAML конструкторами XAML или другими вызывающими, которые требуют дополнительной сериализации. Provides services for XAML serialization by XAML designers or other callers that require advanced serialization.
Абстрактный класс, предоставляющий средства для хранения записей анализатора для последующего создания экземпляров. Abstract class that provides a means to store parser records for later instantiation.
Представляет класс исключений для связанных с синтаксическим анализатором исключений из синтаксического анализатора XAML WPF. Represents the exception class for parser-specific exceptions from a WPF XAML parser. Это исключение используется в операциях синтаксического анализатора API XAML или XAML WPF из платформ .NET Framework 3.0 и .NET Framework 3.5, а также для выполнения специальных задач синтаксического анализатора XAML WPF путем вызова API XamlReader. This exception is used in XAML API or WPF XAML parser operations from .NET Framework 3.0 and .NET Framework 3.5, or for specific use of the WPF XAML parser by calling XamlReader API.
Считывает входные данные XAML и создает граф объекта с использованием средства чтения XAML по умолчанию в составе WPF и соответствующего средства записи объектов XAML. Reads XAML input and creates an object graph, using the WPF default XAML reader and an associated XAML object writer.
Указывает, что класс может использовать расширение разметки для предоставления значения, и ссылается на обработчик, используемый для операций установки расширения разметки. Indicates that a class can use a markup extension to provide a value, and references a handler to use for markup extension set operations.
Предоставляет данные для обратных вызовов, происходящих, когда модуль записи объектов XAML задает значение с использованием расширения разметки. Provides data for callbacks that are invoked when a XAML object writer sets a value using a markup extension.
Указывает, что класс может использовать преобразователь типов для предоставления значения, и ссылается на обработчик, используемый для вариантов установки преобразователя типов. Indicates that a class can use a type converter to provide a value, and references a handler to use for type converter setting cases.
Предоставляет данные для обратных вызовов, происходящих, когда модуль записи XAML задает значение с использованием вызова преобразователя типов. Provides data for callbacks that are invoked when a XAML writer sets a value using a type converter call.
Предоставляет данные для обратных вызовов, инициируемых, когда XamlObjectWriter задает определенные значения. Provides data for callbacks that are invoked when a XamlObjectWriter sets certain values.
Сопоставляет имя XAML-элемента соответствующему типу (Type) среды CLR в сборках. Maps a XAML element name to the appropriate CLR Type in assemblies.
Предоставляет один статический метод Save (с несколькими перегрузками), который может использоваться для ограниченной сериализации XAML предоставленных объектов времени выполнения в разметку XAML. Provides a single static Save method (multiple overloads) that can be used for limited XAML serialization of provided run-time objects into XAML markup.
Представляет литеральные данные, которые могут отображаться в качестве значения узла Value . Represents literal data that can appear as the value for a Value node.
Инкапсулирует атрибуты объекта DependencyObject, относящиеся к языку XML. Encapsulates the XML language-related attributes of a DependencyObject.
Определяет свойство, которое нужно связать с атрибутом xml:lang. Identifies the property to associate with the xml:lang attribute.
Представляет тег языка для использования в разметке XAML. Represents a language tag for use in XAML markup.
Предоставляет преобразование типов для класса XmlLanguage. Provides type conversion for the XmlLanguage class.
Указывает, что пространство имен XAML может быть включено в другое пространство имен XAML. Specifies that a XAML namespace can be subsumed by another XAML namespace. Как правило, поглощающее пространство имен XAML указывается в определенном ранее XmlnsDefinitionAttribute. Typically, the subsuming XAML namespace is indicated in a previously defined XmlnsDefinitionAttribute.
Указывает сопоставление для каждой сборки между пространством имен XAML и пространством имен CLR, которое затем используется для разрешения типов модулем записи объектов XAML или контекстом схемы XAML. Specifies a mapping on a per-assembly basis between a XAML namespace and a CLR namespace, which is then used for type resolution by a XAML object writer or XAML schema context.
Представляет словарь, содержащий сопоставления xmlns для пространств имен XAML в WPF. Represents a dictionary that contains xmlns mappings for XAML namespaces in WPF.
Определяет рекомендуемый префикс, связываемый с пространством имен XAML для использования XAML при записи элементов и атрибутов в файл XAML (сериализация) или при взаимодействии со средой разработки, поддерживающей возможности редактирования XAML. Identifies a recommended prefix to associate with a XAML namespace for XAML usage, when writing elements and attributes in a XAML file (serialization) or when interacting with a design environment that has XAML editing features.
Интерфейсы
Предоставляет средства анализа элементов, допускающих использование комбинаций дочерних элементов или текста. Provides a means to parse elements that permit mixtures of child elements or text.
Обеспечивает компиляцию разметки и поддержку средств для именованных элементов XAML и присоединения к ним обработчиков событий. Provides markup compile and tools support for named XAML elements and for attaching event handlers to them.
Определяет контракт для способа доступа к именам элементов в определенной области имен XAML, а также способа обеспечения уникальности имен в этой области имен XAML. Defines a contract for how names of elements should be accessed within a particular XAML namescope, and how to enforce uniqueness of names within that XAML namescope.
Унифицирует поддержку перечисляемых типов, коллекций и словарей, которые полезны для предоставления словаря имен в пространстве имен XAML. Unifies enumerable, collection, and dictionary support that are useful for exposing a dictionary of names in a XAML namescope.
Представляет службу, которая сообщает информацию о ситуационных отношениях «объект-свойство» для оценки расширения разметки. Represents a service that reports situational object-property relationships for markup extension evaluation.
Запрашивает, должно ли заданное свойство в текущей области обрабатываться как свойство окружения. Queries for whether a specified property should be treated as ambient in the current scope.
Предоставляет механизм, с помощью которого типы могут объявлять, что они могут получать выражение (или другой класс) из расширения разметки, где выводом является другой тип свойства, а не целевое свойство. Provides a mechanism whereby types can declare that they can receive an expression (or another class) from a markup extension, where the output is a different property type than the target property. Не следует использовать для реализаций .NET Framework 4. Do not use for .NET Framework 4 implementations.
Предоставляет методы, внутренне используемые синтаксическим анализатором WPF XAML для присоединения событий и установщиков событий в компилируемом XAML. Provides methods used internally by the WPF XAML parser to attach events and event setters in compiled XAML.
Представляет службу, которая может использовать контекст приложения для разрешения предоставленного относительного URI в абсолютный URI. Represents a service that can use application context to resolve a provided relative URI to an absolute URI.
Определяет контекст, который предоставляется ValueSerializer. Defines a context that is provided to a ValueSerializer. Контекст может использоваться для особых случаев сериализации или различных режимов сериализации. The context can be used to enable special cases of serialization or different modes of serialization.
Представляет службу, которая преобразует именованные элементы разметки XAML в соответствующий тип CLR. Represents a service that resolves from named elements in XAML markup to the appropriate CLR type.
Перечисления
Определяет, как должно быть сериализовано свойство. Specifies how a property is to be serialized.
Определяет режим модуля записи XAML для сериализации значений, являющихся выражениями (такими как привязка объявлений). Specifies the XAML writer mode for serializing values that are expressions (such as binding declarations).
Описывает возможные состояния записи для настраиваемого модуля записи XAML. Describes possible writing states for a custom XAML writer.
