XAttribute Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет XML-атрибут.
public ref class XAttribute : System::Xml::Linq::XObjectpublic class XAttribute : System.Xml.Linq.XObjecttype XAttribute = class
inherit XObjectPublic Class XAttribute
Inherits XObject- Наследование
Комментарии
Атрибут XML — это пара "имя-значение", связанная с XML-элементом.
Каждый XElement содержит список атрибутов для этого элемента. Атрибуты должны иметь полное имя, уникальное для элемента. Атрибуты не являются производными от XNode; они не являются узлами в дереве XML. Вместо этого они являются просто парами name/value, связанными с элементом.
Атрибуты сохраняются в xml-дереве в том порядке, в который они были добавлены в элемент. При возврате Attributesколлекции атрибутов они возвращаются в том порядке, в каком порядке они были добавлены в элемент, и не отсортированы.
Технически в XML объявления пространства имен не являются соответствующими атрибутами. Однако это различие обычно не делается многими программистами XML. Вместо этого, поскольку объявления пространства имен имеют точно тот же синтаксис XML, что и атрибуты, большинство программистов XML считают пространства имен атрибутами. Чтобы упростить интерфейс программирования LINQ to XML, пространства имен представлены в дереве XML в виде атрибутов. Такие атрибуты пространства имен влияют на сериализацию XML-дерева. При сериализации LINQ to XML пытается сериализовать с префиксом пространства имен, указанным в атрибутах пространства имен. Можно использовать IsNamespaceDeclaration для определения того, является ли атрибут действительно объявлением пространства имен.
Класс XAttribute является производным от XObject. Вы можете добавлять заметки в атрибуты и наблюдать за событиями для них.
Некоторые XAttribute методы можно использовать из XAML. Дополнительные сведения см. в LINQ to XML: динамические свойства.
Конструкторы
| Имя | Описание |
|---|---|
| XAttribute(XAttribute) |
Инициализирует новый экземпляр класса из другого XAttributeXAttribute объекта. |
| XAttribute(XName, Object) |
Инициализирует новый экземпляр класса из указанного XAttribute имени и значения. |
Свойства
| Имя | Описание |
|---|---|
| BaseUri |
Получает базовый универсальный код ресурса (URI) для этого XObject. (Унаследовано от XObject) |
| Document |
XDocument Возвращает значение для этогоXObject. (Унаследовано от XObject) |
| EmptySequence |
Возвращает пустую коллекцию атрибутов. |
| IsNamespaceDeclaration |
Определяет, является ли этот атрибут объявлением пространства имен. |
| Name |
Возвращает развернутое имя этого атрибута. |
| NextAttribute |
Возвращает следующий атрибут родительского элемента. |
| NodeType |
Возвращает тип узла для этого узла. |
| Parent |
Возвращает родительский элемент XElement этого XObjectэлемента. (Унаследовано от XObject) |
| PreviousAttribute |
Возвращает предыдущий атрибут родительского элемента. |
| Value |
Возвращает или задает значение этого атрибута. |
Методы
| Имя | Описание |
|---|---|
| AddAnnotation(Object) |
Добавляет объект в список заметок этого XObjectобъекта. (Унаследовано от XObject) |
| Annotation(Type) |
Получает первый объект заметки указанного типа из этого XObject. (Унаследовано от XObject) |
| Annotation<T>() |
Получает первый объект заметки указанного типа из этого XObject. (Унаследовано от XObject) |
| Annotations(Type) |
Возвращает коллекцию заметок указанного типа для этого XObject. (Унаследовано от XObject) |
| Annotations<T>() |
Возвращает коллекцию заметок указанного типа для этого XObject. (Унаследовано от XObject) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Remove() |
Удаляет этот атрибут из родительского элемента. |
| RemoveAnnotations(Type) |
Удаляет заметки указанного типа из этого XObject. (Унаследовано от XObject) |
| RemoveAnnotations<T>() |
Удаляет заметки указанного типа из этого XObject. (Унаследовано от XObject) |
| SetValue(Object) |
Задает значение этого атрибута. |
| ToString() |
Преобразует текущий XAttribute объект в строковое представление. |
Операторы
События
| Имя | Описание |
|---|---|
| Changed |
Вызывается, когда это XObject или любой из его потомков изменились. (Унаследовано от XObject) |
| Changing |
Вызывается, когда это XObject или любой из его потомков собираются изменить. (Унаследовано от XObject) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| IXmlLineInfo.HasLineInfo() |
Возвращает значение, указывающее, имеет ли эта XObject строка сведения. (Унаследовано от XObject) |
| IXmlLineInfo.LineNumber |
Возвращает номер строки, сообщаемой базовой XmlReader строкой для этого XObject. (Унаследовано от XObject) |
| IXmlLineInfo.LinePosition |
Возвращает позицию строки, которая отображается в базовом XmlReader отчете для этого XObject. (Унаследовано от XObject) |
Методы расширения
| Имя | Описание |
|---|---|
| GetSchemaInfo(XAttribute) |
Возвращает набор сведений после проверки схемы (PSVI) проверенного атрибута. |
| Validate(XAttribute, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean) |
Проверяет соответствие XAttribute заданному XmlSchemaObject и XmlSchemaSetнеобязательному заполнению XML-дерева набором сведений после проверки схемы (PSVI). |
| Validate(XAttribute, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler) |
Этот метод проверяет соответствие XAttribute заданному и заданному XmlSchemaObjectXmlSchemaSet. |
