Пространства имен XAML в Xamarin.Forms
XAML использует XML-атрибут XML для объявлений пространства имен. В этой статье представлен синтаксис пространства имен XAML и демонстрируется объявление пространства имен XAML для доступа к типу.
Обзор
Существует два объявления пространства имен XAML, которые всегда находятся в корневом элементе XAML-файла. Первый определяет пространство имен по умолчанию, как показано в следующем примере кода XAML:
xmlns="http://xamarin.com/schemas/2014/forms"
Пространство имен по умолчанию указывает, что элементы, определенные в XAML-файле без префикса, ссылаются на Xamarin.Forms классы, например ContentPage.
Второе объявление пространства имен использует x префикс, как показано в следующем примере кода XAML:
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
XAML использует префиксы для объявления пространств имен, отличных от по умолчанию, с префиксом, используемым при ссылке на типы в пространстве имен. Объявление x пространства имен указывает, что элементы, определенные в XAML с префиксом x , используются для элементов и атрибутов, встроенных в XAML (в частности спецификации XAML 2009).
В следующей таблице описаны атрибуты пространства имен, x поддерживаемые Xamarin.Forms:
| Конструкция | Description |
|---|---|
x:Arguments |
Задает аргументы конструктора для конструктора, отличного от по умолчанию, или для объявления объекта метода фабрики. |
x:Class |
Задает пространство имен и имя класса для класса, определенного в XAML. Имя класса должно соответствовать имени класса файла code-behind. Обратите внимание, что эта конструкция может отображаться только в корневом элементе XAML-файла. |
x:DataType |
Указывает тип объекта, к которому будет привязан элемент XAML, к которому будет привязан дочерний элемент. |
x:FactoryMethod |
Указывает метод фабрики, который можно использовать для инициализации объекта. |
x:FieldModifier |
Задает уровень доступа для созданных полей для именованных элементов XAML. |
x:Key |
Задает уникальный определяемый пользователем ключ для каждого ресурса.ResourceDictionary Значение ключа используется для получения ресурса XAML и обычно используется в качестве аргумента StaticResource расширения разметки. |
x:Name |
Указывает имя объекта среды выполнения для элемента XAML. Параметр x:Name аналогичен объявлению переменной в коде. |
x:TypeArguments |
Задает аргументы универсального типа конструктору универсального типа. |
Дополнительные сведения об атрибуте x:DataType см. в разделе "Скомпилированные привязки". Дополнительные сведения об атрибуте x:FieldModifier см. в разделе "Модификаторы полей". Дополнительные сведения об x:Arguments и x:FactoryMethod атрибутах см. в разделе "Передача аргументов" в XAML. Дополнительные сведения об x:TypeArguments атрибуте см. в разделе Generics in XAML with Xamarin.Forms.
Примечание.
Помимо атрибутов пространства имен, перечисленных выше, Xamarin.Forms также включает расширения разметки, которые можно использовать через x префикс пространства имен. Дополнительные сведения см. в разделе "Использование расширений разметки XAML".
В XAML объявления пространства имен наследуются от родительского элемента к дочернему элементу. Поэтому при определении пространства имен в корневом элементе XAML-файла все элементы в этом файле наследуют объявление пространства имен.
Объявление пространств имен для типов
Типы можно ссылаться на XAML, объявив пространство имен XAML с префиксом, с объявлением пространства имен, указывающим имя пространства имен среды CLR и необязательно имя сборки. Это достигается путем определения значений для следующих ключевых слов в объявлении пространства имен:
- clr-namespace: или using: — пространство имен CLR, объявленное в сборке, содержащей типы, предоставляемые в виде элементов XAML. Это ключевое слово является обязательным.
- assembly= — сборка, содержащая указанное пространство имен CLR. Это значение — имя сборки без расширения файла. Путь к сборке должен быть установлен в качестве ссылки в файле проекта, который содержит XAML-файл, который будет ссылаться на сборку. Это ключевое слово может быть опущено, если значение пространства имен clr находится в той же сборке, что и код приложения, ссылающийся на типы.
Обратите внимание, что символ, разделяющий маркер от его значения, является двоеточием, а символ, разделяющий clr-namespace using assembly маркер от его значения, является знаком равенства. Символ, используемый между двумя маркерами, является точкой с запятой.
В следующем примере кода показано объявление пространства имен XAML:
<ContentPage ... xmlns:local="clr-namespace:HelloWorld" ...>
...
</ContentPage>
Кроме того, это можно написать следующим образом:
<ContentPage ... xmlns:local="using:HelloWorld" ...>
...
</ContentPage>
Префикс local — это соглашение, используемое для указания того, что типы в пространстве имен являются локальными для приложения. Кроме того, если типы находятся в другой сборке, имя сборки также должно быть определено в объявлении пространства имен, как показано в следующем примере кода XAML:
<ContentPage ... xmlns:behaviors="clr-namespace:Behaviors;assembly=BehaviorsLibrary" ...>
...
</ContentPage>
Затем префикс пространства имен указывается при объявлении экземпляра типа из импортированного пространства имен, как показано в следующем примере кода XAML:
<ListView ...>
<ListView.Behaviors>
<behaviors:EventToCommandBehavior EventName="ItemSelected" ... />
</ListView.Behaviors>
</ListView>
Сведения об определении схемы пользовательского пространства имен см. в разделе "Схемы пользовательского пространства имен XAML".
Итоги
В этой статье представлен синтаксис пространства имен XAML и показано, как объявить пространство имен XAML для доступа к типу. XAML использует xmlns XML-атрибут для объявлений пространства имен и типы можно ссылаться на XAML, объявляя пространство имен XAML с префиксом.