XmlnsPrefixAttribute Класс

Определение

Пространство имен:

System.Windows.Markup

Сборка:

System.Xaml.dll

Определяет рекомендуемый префикс для связывания с пространством имен XAML для использования XAML, при написании элементов и атрибутов в XAML-файле (сериализации) или при взаимодействии с средой разработки с функциями редактирования XAML.

public ref class XmlnsPrefixAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)]
public sealed class XmlnsPrefixAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)>]
type XmlnsPrefixAttribute = class
    inherit Attribute

Public NotInheritable Class XmlnsPrefixAttribute
Inherits Attribute

Наследование

Object

Attribute

XmlnsPrefixAttribute

Атрибуты

AttributeUsageAttribute

Комментарии

Процессоры XAML или платформы, включающие XAML или любой процесс, выполняющий сериализацию XAML, обычно должны учитывать рекомендуемый префикс. Префикс может потребоваться в любом случае, если префиксы из определенных сопоставлений в исходном источнике XAML не сохраняются в графе объектов среды выполнения или в противном случае хранятся платформой или технологией. У платформы могут быть определенные предпочтения по сериализации собственных типов, которые игнорируют рекомендуемый префикс из собственных сборок; Это может быть сделано для последовательного повышения пространства имен XAML по умолчанию. Однако такая платформа по-прежнему должна предоставлять рекомендуемые префиксы для возможных сторонних производителей и использования инструментов своих типов XAML. См. раздел "Рекомендации по поддержке конструктора XAML или общая сериализация" ниже.

Общая рекомендация для префиксов — использовать короткие строки, так как префикс обычно применяется ко всем сериализованным элементам, поступающим из пространства имен XAML. Длина строки префикса может иметь заметное влияние на размер сериализованных выходных данных XAML.

Если запрашиваемый префикс уже используется другим ранее встречаемым или сериализованным идентификатором пространства имен XAML, поведение не указано (поведение соответствует каждой отдельной реализации процессора XAML).

В большинстве случаев применяется XmlnsPrefixAttribute только в том случае, если вы также применили хотя бы одну XmlnsDefinitionAttribute в сборке для этого же пространства имен XAML.

В предыдущих версиях .NET Framework этот класс существовал в сборке WPF для WindowsBase. В .NET Framework 4 XmlnsPrefixAttribute находится в сборке System.Xaml. Дополнительные сведения см. в разделе "Типы, перенесенные из WPF в System.Xaml".

Рекомендации по поддержке конструктора XAML или общей сериализации

Даже если связанное пространство имен XAML должно быть пространством имен XAML по умолчанию в большинстве случаев использования для платформы или библиотеки, необходимо указать непустую строку в качестве рекомендуемого префикса для пространства имен XAML. Сведения о пространстве имен XAML по умолчанию передаются в отдельные файлы XAML и потоки узлов XAML. Пространство имен XAML по умолчанию и его определение в заданном источнике XAML можно легко увековечивать для сериализации по регистру без использования XmlnsPrefixAttribute. Однако это полезно для случаев, XmlnsPrefixAttribute когда автор XAML выбрал сопоставление пространства имен XAML по умолчанию с чем-то другим. В этом сценарии текстовый редактор XAML, внедренный в среду разработки, может использовать XmlnsPrefixAttribute в качестве указания для первоначального сопоставления пространства xmlns имен XAML. Или среда разработки может добавлять сопоставления jit-in-time в резервный XAML для метафор проектирования, таких как перетаскивание объектов из панели элементов и в область визуального конструктора. Кроме того, можно предположить, что конструктор может одновременно поддерживать несколько платформ, включающих XAML, и имеет общий сериализатор XAML, основанный на службах XAML .NET Framework, а не на сериализации платформы. Указание XmlnsPrefixAttribute для этих сценариев помогает сделать использование XAML для типов более переносимыми и надежными, если XAML обменивается между инструментами разработки или проходит круговую поездку между редакторами XAML и другими потребителями, такими как компиляторы разметки или другая сериализация.

Конструкторы

Имя	Описание
XmlnsPrefixAttribute(String, String)	Инициализирует новый экземпляр класса XmlnsPrefixAttribute.

Свойства

Имя	Описание
Prefix	Возвращает рекомендуемый префикс, связанный с этим атрибутом.
XmlNamespace	Возвращает идентификатор пространства имен XAML, связанный с этим атрибутом.

См. также раздел

• Атрибуты среды CLR, связанные с XAML, для пользовательских типов и библиотек
• пользовательские типы Define для использования со службами XAML .NET
• Службы XAML