XText 類別

定義

命名空間:

System.Xml.Linq

組件:

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)	從另一個 XText 物件初始化 XText 類別的新執行個體。

屬性

BaseUri	取得此 XObject 的基底 URI。 (繼承來源 XObject)
Document	取得此 XDocument 的 XObject。 (繼承來源 XObject)
NextNode	取得這個節點的下一個同層級 (Sibling) 節點。 (繼承來源 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)	使用 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()	將這個節點從其父代 (Parent) 移除。 (繼承來源 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)	建立 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 概觀