XText Класс

Определение

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

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
Наследование
Производный

Комментарии

XML-элементы могут содержать текстовое содержимое.XML elements can contain text content. Иногда содержимое является простым (элемент содержит только текстовое содержимое), а иногда содержимое является смешанным (содержимое элемента содержит как текст, так и другие элементы).Sometimes the content is simple (the element only contains text content), and sometimes the content is mixed (the contents of the element contains both text and other elements). В любом случае каждый фрагмент текста представляется как XText узел.In either case, each chunk of text is represented as an XText node.

Разработчикам LINQ to XML часто приходится писать код для работы с произвольными LINQ to XML деревьями, которые они не создали.LINQ to XML developers will often have to write code to work with arbitrary LINQ to XML trees that they did not create. При написании кода, который должен работать с LINQ to XML деревьями, которые не контролируют создание, следует иметь в виду поведение XText узлов.If you are writing code that has to work with LINQ to XML trees that you have no control over creating, you should be aware of certain behaviors of XText nodes.

При обработке содержимого дерева XML на уровне узла необходимо подготовить несколько XText узлов друг к другу.When processing the contents of an XML tree at the node level, you should be prepared for multiple XText nodes to be adjacent to each other. Кроме того, необходимо подготовиться к XText узлам, которые не содержат текста.Further, you should be prepared for XText nodes that contain no text. С помощью методов LINQ to XML можно удалить содержимое текстового узла.It is possible through LINQ to XML methods to remove the content of a text node. Однако LINQ to XML не удаляет узел автоматически.However, LINQ to XML does not automatically delete the node. Узел имеет удостоверение и может иметь заметки, поэтому LINQ to XML допускает узлы нулевой длины в дереве.The node has identity, and might have annotations, so LINQ to XML allows for zero-length nodes in the tree.

Дополнительные сведения см. в разделе программирование с использованием узлов.For more information, see Programming with nodes.

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

XText(String)

Инициализирует новый экземпляр класса XText.Initializes a new instance of the XText class.

XText(XText)

Инициализирует новый экземпляр класса XText из другого объекта XText.Initializes a new instance of the XText class from another XText object.

Свойства

BaseUri

Получение базового URI для данного XObject.Gets the base URI for this XObject.

(Унаследовано от XObject)
Document

Получает объект XDocument для данного элемента XObject.Gets the XDocument for this XObject.

(Унаследовано от XObject)
NextNode

Возвращает для данного узла следующий узел того же уровня.Gets the next sibling node of this node.

(Унаследовано от XNode)
NodeType

Возвращает тип узла для этого узла.Gets the node type for this node.

Parent

Возвращает родительский объект XElement этого объекта XObject.Gets the parent XElement of this XObject.

(Унаследовано от XObject)
PreviousNode

Возвращает предыдущий узел того же уровня для данного узла.Gets the previous sibling node of this node.

(Унаследовано от XNode)
Value

Возвращает или задает значение этого узла.Gets or sets the value of this node.

Методы

AddAfterSelf(Object)

Добавляет указанное содержимое непосредственно после данного узла.Adds the specified content immediately after this node.

(Унаследовано от XNode)
AddAfterSelf(Object[])

Добавляет указанное содержимое непосредственно после данного узла.Adds the specified content immediately after this node.

(Унаследовано от XNode)
AddAnnotation(Object)

Добавление объекта в список примечаний данного XObject.Adds an object to the annotation list of this XObject.

(Унаследовано от XObject)
AddBeforeSelf(Object)

Добавляет указанное содержимое непосредственно перед данным узлом.Adds the specified content immediately before this node.

(Унаследовано от XNode)
AddBeforeSelf(Object[])

Добавляет указанное содержимое непосредственно перед данным узлом.Adds the specified content immediately before this node.

(Унаследовано от XNode)
Ancestors()

Возвращает коллекцию элементов-предков данного узла.Returns a collection of the ancestor elements of this node.

(Унаследовано от XNode)
Ancestors(XName)

Возвращает отфильтрованную коллекцию элементов-предков данного узла.Returns a filtered collection of the ancestor elements of this node. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

(Унаследовано от XNode)
Annotation(Type)

Получение первого объекта примечаний заданного типа из данного XObject.Gets the first annotation object of the specified type from this XObject.

(Унаследовано от XObject)
Annotation<T>()

Получение первого объекта примечаний заданного типа из данного XObject.Gets the first annotation object of the specified type from this XObject.

(Унаследовано от XObject)
Annotations(Type)

Получение коллекции примечаний заданного типа для данного XObject.Gets a collection of annotations of the specified type for this XObject.

(Унаследовано от XObject)
Annotations<T>()

Получение коллекции примечаний заданного типа для данного XObject.Gets a collection of annotations of the specified type for this XObject.

(Унаследовано от XObject)
CreateReader()

Создает объект XmlReader для данного узла.Creates an XmlReader for this node.

(Унаследовано от XNode)
CreateReader(ReaderOptions)

Создает объект XmlReader с характеристиками, заданными параметром readerOptions.Creates an XmlReader with the options specified by the readerOptions parameter.

(Унаследовано от XNode)
ElementsAfterSelf()

Возвращает после данного узла коллекцию элементов того же уровня в порядке их следования в документе.Returns a collection of the sibling elements after this node, in document order.

(Унаследовано от XNode)
ElementsAfterSelf(XName)

Возвращает после данного узла отфильтрованную коллекцию элементов того же уровня в порядке их следования в документе.Returns a filtered collection of the sibling elements after this node, in document order. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

(Унаследовано от XNode)
ElementsBeforeSelf()

Возвращает перед данным узлом коллекцию элементов того же уровня в порядке их следования в документе.Returns a collection of the sibling elements before this node, in document order.

(Унаследовано от XNode)
ElementsBeforeSelf(XName)

Возвращает перед данным узлом отфильтрованную коллекцию элементов того же уровня в порядке их следования в документе.Returns a filtered collection of the sibling elements before this node, in document order. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

(Унаследовано от XNode)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
IsAfter(XNode)

Определяет, следует ли текущий узел за указанным в последовательности их расположения в документе.Determines if the current node appears after a specified node in terms of document order.

(Унаследовано от XNode)
IsBefore(XNode)

Определяет, предшествует ли текущий узел указанному в последовательности их расположения в документе.Determines if the current node appears before a specified node in terms of document order.

(Унаследовано от XNode)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
NodesAfterSelf()

Возвращает после данного узла коллекцию узлов того же уровня в порядке их следования в документе.Returns a collection of the sibling nodes after this node, in document order.

(Унаследовано от XNode)
NodesBeforeSelf()

Возвращает перед данным узлом коллекцию узлов того же уровня в порядке их следования в документе.Returns a collection of the sibling nodes before this node, in document order.

(Унаследовано от XNode)
Remove()

Удаляет данный узел из родительского объекта.Removes this node from its parent.

(Унаследовано от XNode)
RemoveAnnotations(Type)

Удаление примечаний заданного типа из данного XObject.Removes the annotations of the specified type from this XObject.

(Унаследовано от XObject)
RemoveAnnotations<T>()

Удаление примечаний заданного типа из данного XObject.Removes the annotations of the specified type from this XObject.

(Унаследовано от XObject)
ReplaceWith(Object)

Заменяет данный узел на указанное содержимое.Replaces this node with the specified content.

(Унаследовано от XNode)
ReplaceWith(Object[])

Заменяет данный узел на указанное содержимое.Replaces this node with the specified content.

(Унаследовано от XNode)
ToString()

Возвращает предназначенный для данного узла XML.Returns the indented XML for this node.

(Унаследовано от XNode)
ToString(SaveOptions)

Возвращает XML для данного узла (с возможным отключением форматирования).Returns the XML for this node, optionally disabling formatting.

(Унаследовано от XNode)
WriteTo(XmlWriter)

Записывает данный узел в объект XmlWriter.Writes this node to an XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

Асинхронно записывает этот объект XText в указанный объект XmlWriter.Asynchronously writes this XText to the specified XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

Записывает текущий узел в XmlWriter.Writes the current node to an XmlWriter.

(Унаследовано от XNode)

События

Changed

Возникновение в случае изменения данного XObject или одного из его подчиненных элементов.Raised when this XObject or any of its descendants have changed.

(Унаследовано от XObject)
Changing

Возникновение в случае возможного изменения данного XObject или одного из его подчиненных элементов.Raised when this XObject or any of its descendants are about to change.

(Унаследовано от XObject)

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

IXmlLineInfo.HasLineInfo()

Получение значения, указывающего, есть ли у данного XObject сведения строки.Gets a value indicating whether or not this XObject has line information.

(Унаследовано от XObject)
IXmlLineInfo.LineNumber

Получения номера строки, которую базовый XmlReader сообщил для данного XObject.Gets the line number that the underlying XmlReader reported for this XObject.

(Унаследовано от XObject)
IXmlLineInfo.LinePosition

Получения номера позиции, которую базовый XmlReader сообщил для данного XObject.Gets the line position that the underlying XmlReader reported for this XObject.

(Унаследовано от XObject)

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

CreateNavigator(XNode)

Создает XPathNavigator для XNode.Creates an XPathNavigator for an XNode.

CreateNavigator(XNode, XmlNameTable)

Создает XPathNavigator для XNode.Creates an XPathNavigator for an XNode. XmlNameTable обеспечивает более эффективную обработку выражений XPath.The XmlNameTable enables more efficient XPath expression processing.

XPathEvaluate(XNode, String)

Вычисляет выражение XPath.Evaluates an XPath expression.

XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Вычисляет выражение XPath, разрешая префиксы пространств имен с помощью указанного IXmlNamespaceResolver.Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElement(XNode, String)

Выбирает XElement с помощью выражения XPath.Selects an XElement using a XPath expression.

XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Выбирает XElement с помощью выражения XPath, разрешая префиксы пространства имен с помощью указанного IXmlNamespaceResolver.Selects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElements(XNode, String)

Выбирает коллекцию элементов с помощью выражения XPath.Selects a collection of elements using an XPath expression.

XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Выбирает коллекцию элементов с помощью выражения XPath, разрешая префиксы пространства имен с помощью указанного IXmlNamespaceResolver.Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

ToXPathNavigable(XNode)

Возвращает метод доступа, который позволяет переходить к указанному XNode и редактировать его.Returns an accessor that allows you to navigate and edit the specified XNode.

Применяется к