XText Class
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Represents a text node.
System.Xml.Linq::XObject
System.Xml.Linq::XNode
System.Xml.Linq::XText
System.Xml.Linq::XCData
Assembly: System.Xml.Linq (in System.Xml.Linq.dll)
The XText type exposes the following members.
| Name | Description | |
|---|---|---|
 | XText(String) | Initializes a new instance of the XText class. |
| XText(XText) | Initializes a new instance of the XText class from another XText object. |
| Name | Description | |
|---|---|---|
 | BaseUri | Gets the base URI for this XObject. (Inherited from XObject.) |
| Document | Gets the XDocument for this XObject. (Inherited from XObject.) |
| NextNode | Gets the next sibling node of this node. (Inherited from XNode.) |
| NodeType | Gets the node type for this node. (Overrides XObject::NodeType.) |
| Parent | Gets the parent XElement of this XObject. (Inherited from XObject.) |
| PreviousNode | Gets the previous sibling node of this node. (Inherited from XNode.) |
| Value | Gets or sets the value of this node. |
| Name | Description | |
|---|---|---|
| AddAfterSelf(Object) | Adds the specified content immediately after this node. (Inherited from XNode.) |
| AddAfterSelf(array<Object>) | Adds the specified content immediately after this node. (Inherited from XNode.) |
| AddAnnotation | Adds an object to the annotation list of this XObject. (Inherited from XObject.) |
| AddBeforeSelf(Object) | Adds the specified content immediately before this node. (Inherited from XNode.) |
| AddBeforeSelf(array<Object>) | Adds the specified content immediately before this node. (Inherited from XNode.) |
| Ancestors() | Returns a collection of the ancestor elements of this node. (Inherited from XNode.) |
| Ancestors(XName) | Returns a filtered collection of the ancestor elements of this node. Only elements that have a matching XName are included in the collection. (Inherited from XNode.) |
| Annotation(Type) | Gets the first annotation object of the specified type from this XObject. (Inherited from XObject.) |
| Annotation<T>() | Get the first annotation object of the specified type from this XObject. (Inherited from XObject.) |
| Annotations(Type) | Gets a collection of annotations of the specified type for this XObject. (Inherited from XObject.) |
| Annotations<T>() | Gets a collection of annotations of the specified type for this XObject. (Inherited from XObject.) |
| CreateReader() | Creates an XmlReader for this node. (Inherited from XNode.) |
| CreateReader(ReaderOptions) | Creates an XmlReader for this node. (Inherited from XNode.) |
| ElementsAfterSelf() | Returns a collection of the sibling elements after this node, in document order. (Inherited from XNode.) |
| ElementsAfterSelf(XName) | Returns a filtered collection of the sibling elements after this node, in document order. Only elements that have a matching XName are included in the collection. (Inherited from XNode.) |
| ElementsBeforeSelf() | Returns a collection of the sibling elements before this node, in document order. (Inherited from XNode.) |
| ElementsBeforeSelf(XName) | Returns a filtered collection of the sibling elements before this node, in document order. Only elements that have a matching XName are included in the collection. (Inherited from XNode.) |
| Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| IsAfter | Determines if the current node appears after a specified node in terms of document order. (Inherited from XNode.) |
| IsBefore | Determines if the current node appears before a specified node in terms of document order. (Inherited from XNode.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| NodesAfterSelf | Returns a collection of the sibling nodes after this node, in document order. (Inherited from XNode.) |
| NodesBeforeSelf | Returns a collection of the sibling nodes before this node, in document order. (Inherited from XNode.) |
| Remove | Removes this node from its parent. (Inherited from XNode.) |
| RemoveAnnotations(Type) | Removes the annotations of the specified type from this XObject. (Inherited from XObject.) |
| RemoveAnnotations<T>() | Removes the annotations of the specified type from this XObject. (Inherited from XObject.) |
| ReplaceWith(Object) | Replaces this node with the specified content. (Inherited from XNode.) |
| ReplaceWith(array<Object>) | Replaces this node with the specified content. (Inherited from XNode.) |
| ToString() | Returns the indented XML for this node. (Inherited from XNode.) |
| ToString(SaveOptions) | Returns the XML for this node, optionally disabling formatting. (Inherited from XNode.) |
| WriteTo | Writes this node to an XmlWriter. (Overrides XNode::WriteTo(XmlWriter).) |
| Name | Description | |
|---|---|---|
  | IXmlLineInfo::HasLineInfo | Gets a value indicating whether or not this XObject has line information. (Inherited from XObject.) |
 | IXmlLineInfo::LineNumber | Gets the line number that the underlying XmlReader reported for this XObject. (Inherited from XObject.) |
| IXmlLineInfo::LinePosition | Gets the line position that the underlying XmlReader reported for this XObject. (Inherited from XObject.) |
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). In either case, each chunk of text is represented as an XText node.
LINQ to XML developers will often have to write code to work with arbitrary LINQ to XML trees that they did not create. 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.
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. Further, you should be prepared for XText nodes that contain no text. It is possible through LINQ to XML methods to remove the content of a text node. However, LINQ to XML does not automatically delete the node. 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 in the .NET Framework documentation.