XText 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表一個文字節點。
public ref class XText : System::Xml::Linq::XNodepublic class XText : System.Xml.Linq.XNodetype XText = class
inherit XNodePublic Class XText
Inherits XNode- 繼承
- 衍生
備註
XML 元素可以包含文字內容。 有時內容很簡單（元素只包含文字內容），有時內容混合（元素內容同時包含文字與其他元素）。 無論哪種情況，每個文字區塊都以節點 XText 形式表示。
LINQ 轉 XML 的開發者通常必須撰寫程式碼來處理他們未建立的任意 LINQ 轉 XML 樹。 如果你寫的程式碼必須用 LINQ 轉 XML 樹，且你無法控制建立，你應該注意節點的 XText 某些行為。
在節點層處理 XML 樹內容時，你應該準備好多個 XText 節點彼此相鄰的情況。 此外，你應該準備好面對 XText 沒有文字的節點。 透過 LINQ 轉 XML 方法，可以移除文字節點的內容。 然而，LINQ 轉 XML 並不會自動刪除該節點。 節點具有身份，且可能有註解，因此 LINQ 轉 XML 允許樹中節點長度為零。
欲了解更多資訊，請參閱 「節點程式設計」。
建構函式
| 名稱 | Description |
|---|---|
| XText(String) |
初始化 XText 類別的新執行個體。 |
| XText(XText) |
屬性
| 名稱 | Description |
|---|---|
| BaseUri |
取得基本的 URI 來處理這個 XObject。 (繼承來源 XObject) |
| Document | (繼承來源 XObject) |
| NextNode |
取得該節點的下一個兄弟節點。 (繼承來源 XNode) |
| NodeType |
取得該節點的節點類型。 |
| Parent | (繼承來源 XObject) |
| PreviousNode |
取得該節點的前一個兄弟節點。 (繼承來源 XNode) |
| Value |
取得或設定此節點的值。 |
方法
| 名稱 | Description |
|---|---|
| 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選項的 。 |
| 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) |
事件
| 名稱 | Description |
|---|---|
| Changed |
當這個 XObject 或其後代改變時，他會被養育。 (繼承來源 XObject) |
| Changing |
當這個 XObject 或其後代即將改變時，他被養育。 (繼承來源 XObject) |
明確介面實作
| 名稱 | Description |
|---|---|
| IXmlLineInfo.HasLineInfo() |
會獲得一個值，表示該項目 XObject 是否有行資訊。 (繼承來源 XObject) |
| IXmlLineInfo.LineNumber |
取得標的資產 XmlReader 報告 XObject的行號。 (繼承來源 XObject) |
| IXmlLineInfo.LinePosition |
取得標的資產 XmlReader 報告 XObject的線位。 (繼承來源 XObject) |
擴充方法
| 名稱 | Description |
|---|---|
| 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) |
使用 XPath 表達式選取 ， XElement 並用指定的 IXmlNamespaceResolver命名空間前綴解析。 |
| XPathSelectElement(XNode, String) |
使用 XPath 表達式選擇 。XElement |
| XPathSelectElements(XNode, String, IXmlNamespaceResolver) |
使用 XPath 表達式選取一組元素，並用指定的 IXmlNamespaceResolver命名空間前綴解析。 |
| XPathSelectElements(XNode, String) |
使用 XPath 表達式選擇一組元素。 |
