Поделиться через


Атрибут x:Class

Обновлен: Ноябрь 2007

Настройка параметров компиляции XAML для объединения разделяемых классов разметки и с выделенным кодом. Разделяемый класс кода определяется в отдельном файле кода на языке Спецификация CLS (Common Language Specification). Разделяемый класс разметки создается генератором кода во время компиляции XAML.

Использование атрибута XAML

<object x:Class="namespace.classname"...>
  ...
</object>

Значения XAML

namespace

Необязательный компонент. Определение пространства имен CLR, содержащего разделяемый класс, который задается параметром classname. Если задан параметр namespace, параметры namespace и classname разделяются точкой (.).

classname

Обязательный компонент. Определение имени CLR разделяемого класса, который связывает загруженный XAML и класс с выделенным кодом для этого XAML. 

Заметки

Атрибут x:Class может объявляться в качестве атрибута любого скомпилированного элемента, который является корнем дерева элементов Язык XAML (Extensible Application Markup Language) (если Язык XAML (Extensible Application Markup Language) включается в проект с действием построения Page), а также для корня объекта Application в определении скомпилированного приложения. Объявление атрибута x:Class для любого элемента, отличного от корня страницы или приложения, а также любого нескомпилированного файла Язык XAML (Extensible Application Markup Language) приведет к ошибке компиляции.

Не допускается использование вложенных классов в качестве атрибута x:Class.

Атрибут x:Class является необязательным. Это означает, что допускается существование страницы XAML, не содержащей с выделенным кодом. Однако если на странице объявляется событие, обрабатывающее значения атрибута, или создаются экземпляры пользовательских элементов, в которых определяющие классы находятся в классе с выделенным кодом, обязательно предоставлять ссылку атрибута x:Class (или атрибута x:Subclass) на соответствующий класс с выделенным кодом. 

Значение атрибута x:Class должно быть строкой, указывающей полное имя класса. Для простых приложений можно пропустить сведения о пространстве имен CLR, поскольку код программной части также структурируется (определение начинается с уровня класса). Файл с выделенным кодом для определения страницы или приложения должен содержаться в файле кода, включаемом в состав проекта, в котором создается скомпилированное приложение. Необходимо соблюдать правила назначения имен классам CLR. Дополнительные сведения см. на странице Определения типов (на английском языке). По умолчанию класс с выделенным кодом должен объявляться с использованием модификатора public, но при необходимости может быть определен с различными уровнями доступа с помощью Атрибут x:ClassModifier.

Обратите внимание, что это значение атрибута x:Class относится только к реализации WPF XAML. В других реализациях XAML вне WPF управляемый код может не использоваться, в связи с чем могут использоваться другие формулы разрешения классов.

См. также

Основные понятия

Язык XAML и пользовательские классы

Выделенный код и XAML

Ссылки

Атрибут x:Subclass

Атрибут x:ClassModifier