XText 类

定义

命名空间:

System.Xml.Linq

程序集:

System.Xml.XDocument.dll

程序集:

System.Xml.Linq.dll

程序集:

netstandard.dll

表示文本节点。

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)	从其他 XText 对象初始化 XText 类的新实例。

属性

BaseUri	获取此 XObject 的基 URI。 (继承自 XObject)
Document	获取此 XDocument 的 XObject。 (继承自 XObject)
NextNode	获取此节点的下一个同级节点。 (继承自 XNode)
NodeType	获取此节点的节点类型。
Parent	获取此 XObject 的父级 XElement。 (继承自 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)	使用 readerOptions 参数指定的选项创建 XmlReader。 (继承自 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)	将此 XmlWriter 异步写入到指定的 XText。
WriteToAsync(XmlWriter, CancellationToken)	将当前节点写入到 XmlWriter。 (继承自 XNode)

事件

Changed	在此 XObject 或其任何子代发生了更改时引发。 (继承自 XObject)
Changing	当此 XObject 或其任何子代要发生更改时引发。 (继承自 XObject)

显式接口实现

IXmlLineInfo.HasLineInfo()	获取一个值，该值指示此 XObject 是否具有行信息。 (继承自 XObject)
IXmlLineInfo.LineNumber	获取基础 XmlReader 为此 XObject 报告的行号。 (继承自 XObject)
IXmlLineInfo.LinePosition	获取基础 XmlReader 为此 XObject 报告的行位置。 (继承自 XObject)

扩展方法

CreateNavigator(XNode)	为 XPathNavigator 创建一个 XNode。
CreateNavigator(XNode, XmlNameTable)	为 XPathNavigator 创建一个 XNode。 XmlNameTable 可以使 XPath 表达式的处理变得更高效。
XPathEvaluate(XNode, String)	计算 XPath 表达式。
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	计算 XPath 表达式，使用指定的 IXmlNamespaceResolver 解析命名空间前缀。
XPathSelectElement(XNode, String)	使用 XPath 表达式选择 XElement。
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	使用 XPath 表达式选择 XElement，并使用指定的 IXmlNamespaceResolver 解析命名空间前缀。
XPathSelectElements(XNode, String)	使用 XPath 表达式选择一个元素集合。
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	使用 XPath 表达式选择一个元素集合，并使用指定的 IXmlNamespaceResolver 解析命名空间前缀。
ToXPathNavigable(XNode)	返回一个访问器，该访问器可用于导航和编辑指定的 XNode。

另请参阅

• LINQ to XML 概述