Атрибут 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 и пользовательские классы