XText Класс

Определение

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

System.Xml.Linq

Сборки:

netstandard.dll, System.Xml.XDocument.dll

Исходный код:

XText.cs

Представляет текстовый узел.

public ref class XText : System::Xml::Linq::XNode

public class XText : System.Xml.Linq.XNode

type XText = class
    inherit XNode

Public Class XText
Inherits XNode

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

Object

XObject

XNode

XText

Производный

System.Xml.Linq.XCData

Комментарии

XML-элементы могут содержать текстовое содержимое. Иногда содержимое просто (элемент содержит только текстовое содержимое), а иногда содержимое смешанно (содержимое элемента содержит как текст, так и другие элементы). В любом случае каждый фрагмент текста представлен как XText узел.

Разработчикам LINQ to XML часто приходится писать код для работы с произвольными деревьями LINQ to XML, которые они не создали. Если вы пишете код, который должен работать с деревьями LINQ to XML, которые у вас нет контроля над созданием, следует учитывать определенные поведения XText узлов.

При обработке содержимого дерева XML на уровне узла необходимо подготовиться к тому, чтобы несколько XText узлов были рядом друг с другом. Кроме того, следует подготовиться к XText узлам, которые не содержат текста. С помощью методов LINQ to XML можно удалить содержимое текстового узла. Однако LINQ to XML не удаляет узел автоматически. Узел имеет удостоверение и может иметь заметки, поэтому LINQ to XML позволяет использовать узлы нулевой длины в дереве.

Дополнительные сведения см. в разделе "Программирование с узлами".

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

Имя	Описание
XText(String)	Инициализирует новый экземпляр класса XText.
XText(XText)	Инициализирует новый экземпляр класса из другого XTextXText объекта.

Свойства

Имя	Описание
BaseUri	Получает базовый универсальный код ресурса (URI) для этого XObject. (Унаследовано от XObject)
Document	XDocument Возвращает значение для этогоXObject. (Унаследовано от XObject)
NextNode	Возвращает следующий одноуровневый узел этого узла. (Унаследовано от XNode)
NodeType	Возвращает тип узла для этого узла.
Parent	Возвращает родительский элемент XElement этого XObjectэлемента. (Унаследовано от XObject)
PreviousNode	Возвращает предыдущий одноуровневый узел этого узла. (Унаследовано от XNode)
Value	Возвращает или задает значение этого узла.

Методы

Имя	Описание
AddAfterSelf(Object)	Добавляет указанное содержимое сразу после этого узла. (Унаследовано от XNode)
AddAfterSelf(Object[])	Добавляет указанное содержимое сразу после этого узла. (Унаследовано от XNode)
AddAnnotation(Object)	Добавляет объект в список заметок этого XObjectобъекта. (Унаследовано от XObject)
AddBeforeSelf(Object)	Добавляет указанное содержимое непосредственно перед этим узлом. (Унаследовано от XNode)
AddBeforeSelf(Object[])	Добавляет указанное содержимое непосредственно перед этим узлом. (Унаследовано от XNode)
Ancestors()	Возвращает коллекцию предки элементов этого узла. (Унаследовано от XNode)
Ancestors(XName)	Возвращает отфильтрованную коллекцию предков элементов этого узла. В коллекцию включены только элементы с соответствующими XName. (Унаследовано от XNode)
Annotation(Type)	Получает первый объект заметки указанного типа из этого XObject. (Унаследовано от XObject)
Annotation<T>()	Получает первый объект заметки указанного типа из этого XObject. (Унаследовано от XObject)
Annotations(Type)	Возвращает коллекцию заметок указанного типа для этого XObject. (Унаследовано от XObject)
Annotations<T>()	Возвращает коллекцию заметок указанного типа для этого XObject. (Унаследовано от XObject)
CreateReader()	XmlReader Создает для этого узла. (Унаследовано от XNode)
CreateReader(ReaderOptions)	XmlReader Создает параметр с параметрами, указанными параметромreaderOptions. (Унаследовано от XNode)
ElementsAfterSelf()	Возвращает коллекцию одноуровневых элементов после этого узла в порядке документа. (Унаследовано от XNode)
ElementsAfterSelf(XName)	Возвращает отфильтрованную коллекцию элементов-братьев после этого узла в порядке документа. В коллекцию включены только элементы с соответствующими XName. (Унаследовано от XNode)
ElementsBeforeSelf()	Возвращает коллекцию одноуровневых элементов перед этим узлом в порядке документа. (Унаследовано от XNode)
ElementsBeforeSelf(XName)	Возвращает отфильтрованную коллекцию элементов-братьев перед этим узлом в порядке документа. В коллекцию включены только элементы с соответствующими XName. (Унаследовано от XNode)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
IsAfter(XNode)	Определяет, отображается ли текущий узел после указанного узла с точки зрения порядка документов. (Унаследовано от XNode)
IsBefore(XNode)	Определяет, отображается ли текущий узел перед указанным узлом с точки зрения порядка документов. (Унаследовано от XNode)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
NodesAfterSelf()	Возвращает коллекцию одноуровневых узлов после этого узла в порядке документа. (Унаследовано от XNode)
NodesBeforeSelf()	Возвращает коллекцию одноуровневых узлов перед этим узлом в порядке документа. (Унаследовано от XNode)
Remove()	Удаляет этот узел из родительского элемента. (Унаследовано от XNode)
RemoveAnnotations(Type)	Удаляет заметки указанного типа из этого XObject. (Унаследовано от XObject)
RemoveAnnotations<T>()	Удаляет заметки указанного типа из этого XObject. (Унаследовано от XObject)
ReplaceWith(Object)	Заменяет этот узел указанным содержимым. (Унаследовано от XNode)
ReplaceWith(Object[])	Заменяет этот узел указанным содержимым. (Унаследовано от XNode)
ToString()	Возвращает отступ xml для этого узла. (Унаследовано от XNode)
ToString(SaveOptions)	Возвращает XML-код для этого узла, при необходимости отключая форматирование. (Унаследовано от XNode)
WriteTo(XmlWriter)	Записывает этот узел в объект XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Асинхронно записывает это XText в указанный XmlWriterобъект.

События

Имя	Описание
Changed	Вызывается, когда это XObject или любой из его потомков изменились. (Унаследовано от XObject)
Changing	Вызывается, когда это XObject или любой из его потомков собираются изменить. (Унаследовано от XObject)

Явные реализации интерфейса

Имя	Описание
IXmlLineInfo.HasLineInfo()	Возвращает значение, указывающее, имеет ли эта XObject строка сведения. (Унаследовано от XObject)
IXmlLineInfo.LineNumber	Возвращает номер строки, сообщаемой базовой XmlReader строкой для этого XObject. (Унаследовано от XObject)
IXmlLineInfo.LinePosition	Возвращает позицию строки, которая отображается в базовом XmlReader отчете для этого XObject. (Унаследовано от XObject)

Методы расширения

Имя	Описание
CreateNavigator(XNode, XmlNameTable)	XPathNavigator Создает объект для XNode. Это XmlNameTable обеспечивает более эффективную обработку выражений XPath.
CreateNavigator(XNode)	XPathNavigator Создает объект для XNode.
ToXPathNavigable(XNode)	Возвращает метод доступа, позволяющий перемещаться и изменять указанный объект XNode.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Вычисляет выражение XPath, разрешая префиксы пространства имен с помощью указанного.IXmlNamespaceResolver
XPathEvaluate(XNode, String)	Вычисляет выражение XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	XElement Выбирает выражение XPath, разрешая префиксы пространства имен с помощью указанного.IXmlNamespaceResolver
XPathSelectElement(XNode, String)	XElement Выбирает выражение XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Выбирает коллекцию элементов с помощью выражения XPath, разрешая префиксы пространства имен с помощью указанного.IXmlNamespaceResolver
XPathSelectElements(XNode, String)	Выбирает коллекцию элементов с помощью выражения XPath.

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

• Обзор LINQ to XML