Windows Dev Center

XElement Class

Represents an XML element. See XElement Class Overview and the Remarks section on this page for usage information and examples.

To browse the .NET Framework source code for this type, see the Reference Source.

Namespace:  System.Xml.Linq
Assemblies:   System.Xml.Linq (in System.Xml.Linq.dll)
  System.Xml.XDocument (in System.Xml.XDocument.dll)

public class XElement : XContainer, IXmlSerializable

The XElement type exposes the following members.

  NameDescription
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryXElement(XElement)Initializes a new instance of the XElement class from another XElement object.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryXElement(XName)Initializes a new instance of the XElement class with the specified name.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryXElement(XStreamingElement)Initializes a new instance of the XElement class from an XStreamingElement object.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryXElement(XName, Object)Initializes a new instance of the XElement class with the specified name and content.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryXElement(XName, Object[])Initializes a new instance of the XElement class with the specified name and content.
Top

  NameDescription
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryBaseUriGets the base URI for this XObject. (Inherited from XObject.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryDocumentGets the XDocument for this XObject. (Inherited from XObject.)
Public propertyStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryEmptySequenceGets an empty collection of elements.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryFirstAttributeGets the first attribute of this element.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryFirstNodeGet the first child node of this node. (Inherited from XContainer.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryHasAttributesGets a value indicating whether this element as at least one attribute.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryHasElementsGets a value indicating whether this element has at least one child element.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryIsEmptyGets a value indicating whether this element contains no content.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryLastAttributeGets the last attribute of this element.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryLastNodeGet the last child node of this node. (Inherited from XContainer.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryNameGets or sets the name of this element.
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryNextNodeGets the next sibling node of this node. (Inherited from XNode.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryNodeTypeGets the node type for this node. (Overrides XObject.NodeType.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryParentGets the parent XElement of this XObject. (Inherited from XObject.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryPreviousNodeGets the previous sibling node of this node. (Inherited from XNode.)
Public propertySupported by the XNA FrameworkSupported by Portable Class LibraryValueGets or sets the concatenated text contents of this element.
Top

  NameDescription
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAdd(Object)Adds the specified content as children of this XContainer. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAdd(Object[])Adds the specified content as children of this XContainer. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAddAfterSelf(Object)Adds the specified content immediately after this node. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAddAfterSelf(Object[])Adds the specified content immediately after this node. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAddAnnotationAdds an object to the annotation list of this XObject. (Inherited from XObject.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAddBeforeSelf(Object)Adds the specified content immediately before this node. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAddBeforeSelf(Object[])Adds the specified content immediately before this node. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAddFirst(Object)Adds the specified content as the first children of this document or element. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAddFirst(Object[])Adds the specified content as the first children of this document or element. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAncestors()Returns a collection of the ancestor elements of this node. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAncestors(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.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAncestorsAndSelf()Returns a collection of elements that contain this element, and the ancestors of this element.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAncestorsAndSelf(XName)Returns a filtered collection of elements that contain this element, and the ancestors of this element. Only elements that have a matching XName are included in the collection.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAnnotation(Type)Gets the first annotation object of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAnnotation<T>()Get the first annotation object of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAnnotations(Type)Gets a collection of annotations of the specified type for this XObject. (Inherited from XObject.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAnnotations<T>()Gets a collection of annotations of the specified type for this XObject. (Inherited from XObject.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAttributeReturns the XAttribute of this XElement that has the specified XName.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAttributes()Returns a collection of attributes of this element.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryAttributes(XName)Returns a filtered collection of attributes of this element. Only elements that have a matching XName are included in the collection.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryCreateReader()Creates an XmlReader for this node. (Inherited from XNode.)
Public methodSupported by Portable Class LibraryCreateReader(ReaderOptions)Creates an XmlReader with the options specified by the readerOptions parameter. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryCreateWriterCreates an XmlWriter that can be used to add nodes to the XContainer. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryDescendantNodesReturns a collection of the descendant nodes for this document or element, in document order. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryDescendantNodesAndSelfReturns a collection of nodes that contain this element, and all descendant nodes of this element, in document order.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryDescendants()Returns a collection of the descendant elements for this document or element, in document order. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryDescendants(XName)Returns a filtered collection of the descendant elements for this document or element, in document order. Only elements that have a matching XName are included in the collection. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryDescendantsAndSelf()Returns a collection of elements that contain this element, and all descendant elements of this element, in document order.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryDescendantsAndSelf(XName)Returns a filtered collection of elements that contain this element, and all descendant elements of this element, in document order. Only elements that have a matching XName are included in the collection.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryElementGets the first (in document order) child element with the specified XName. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryElements()Returns a collection of the child elements of this element or document, in document order. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryElements(XName)Returns a filtered collection of the child elements of this element or document, in document order. Only elements that have a matching XName are included in the collection. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryElementsAfterSelf()Returns a collection of the sibling elements after this node, in document order. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryElementsAfterSelf(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.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryElementsBeforeSelf()Returns a collection of the sibling elements before this node, in document order. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryElementsBeforeSelf(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.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodSupported by the XNA FrameworkSupported by Portable Class LibraryFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetDefaultNamespaceGets the default XNamespace of this XElement.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetNamespaceOfPrefixGets the namespace associated with a particular prefix for this XElement.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetPrefixOfNamespaceGets the prefix associated with a namespace for this XElement.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryIsAfterDetermines if the current node appears after a specified node in terms of document order. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryIsBeforeDetermines if the current node appears before a specified node in terms of document order. (Inherited from XNode.)
Public methodStatic memberSupported by Portable Class LibraryLoad(Stream)Creates a new XElement instance by using the specified stream.
Public methodStatic memberSupported by the XNA FrameworkLoad(String)Loads an XElement from a file.
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryLoad(TextReader)Loads an XElement from a TextReader.
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryLoad(XmlReader)Loads an XElement from an XmlReader.
Public methodStatic memberSupported by Portable Class LibraryLoad(Stream, LoadOptions)Creates a new XElement instance by using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.
Public methodStatic memberSupported by the XNA FrameworkLoad(String, LoadOptions)Loads an XElement from a file, optionally preserving white space, setting the base URI, and retaining line information.
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryLoad(TextReader, LoadOptions)Loads an XElement from a TextReader, optionally preserving white space and retaining line information.
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryLoad(XmlReader, LoadOptions)Loads an XElement from an XmlReader, optionally preserving white space, setting the base URI, and retaining line information.
Protected methodSupported by the XNA FrameworkSupported by Portable Class LibraryMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryNodesReturns a collection of the child nodes of this element or document, in document order. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryNodesAfterSelfReturns a collection of the sibling nodes after this node, in document order. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryNodesBeforeSelfReturns a collection of the sibling nodes before this node, in document order. (Inherited from XNode.)
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryParse(String)Load an XElement from a string that contains XML.
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryParse(String, LoadOptions)Load an XElement from a string that contains XML, optionally preserving white space and retaining line information.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryRemoveRemoves this node from its parent. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryRemoveAllRemoves nodes and attributes from this XElement.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryRemoveAnnotations(Type)Removes the annotations of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryRemoveAnnotations<T>()Removes the annotations of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryRemoveAttributesRemoves the attributes of this XElement.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryRemoveNodesRemoves the child nodes from this document or element. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryReplaceAll(Object)Replaces the child nodes and the attributes of this element with the specified content.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryReplaceAll(Object[])Replaces the child nodes and the attributes of this element with the specified content.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryReplaceAttributes(Object)Replaces the attributes of this element with the specified content.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryReplaceAttributes(Object[])Replaces the attributes of this element with the specified content.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryReplaceNodes(Object)Replaces the children nodes of this document or element with the specified content. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryReplaceNodes(Object[])Replaces the children nodes of this document or element with the specified content. (Inherited from XContainer.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryReplaceWith(Object)Replaces this node with the specified content. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryReplaceWith(Object[])Replaces this node with the specified content. (Inherited from XNode.)
Public methodSupported by Portable Class LibrarySave(Stream)Outputs this XElement to the specified Stream.
Public methodSupported by the XNA FrameworkSave(String)Serialize this element to a file.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySave(TextWriter)Serialize this element to a TextWriter.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySave(XmlWriter)Serialize this element to an XmlWriter.
Public methodSupported by Portable Class LibrarySave(Stream, SaveOptions)Outputs this XElement to the specified Stream, optionally specifying formatting behavior.
Public methodSupported by the XNA FrameworkSave(String, SaveOptions)Serialize this element to a file, optionally disabling formatting.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySave(TextWriter, SaveOptions)Serialize this element to a TextWriter, optionally disabling formatting.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySetAttributeValueSets the value of an attribute, adds an attribute, or removes an attribute.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySetElementValueSets the value of a child element, adds a child element, or removes a child element.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibrarySetValueSets the value of this element.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryToString()Returns the indented XML for this node. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryToString(SaveOptions)Returns the XML for this node, optionally disabling formatting. (Inherited from XNode.)
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryWriteToWrite this element to an XmlWriter. (Overrides XNode.WriteTo(XmlWriter).)
Top

  NameDescription
Public eventSupported by the XNA FrameworkSupported by Portable Class LibraryChangedRaised when this XObject or any of its descendants have changed. (Inherited from XObject.)
Public eventSupported by the XNA FrameworkSupported by Portable Class LibraryChangingRaised when this XObject or any of its descendants are about to change. (Inherited from XObject.)
Top

  NameDescription
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Single)Cast the value of this XElement to a Single.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<Int64>)Cast the value of this XElement to a Nullable<T> of Int64.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Int64)Cast the value of this XElement to an Int64.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to UInt64)Cast the value of this XElement to a UInt64.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<UInt32>)Cast the value of this XElement to a Nullable<T> of UInt32.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<UInt64>)Cast the value of this XElement to a Nullable<T> of UInt64.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<Single>)Cast the value of this XElement to a Nullable<T> of Single.
Public operatorStatic memberSupported by Portable Class LibraryExplicit(XElement to DateTimeOffset)Cast the value of this XAttribute to a DateTimeOffset.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<DateTime>)Cast the value of this XElement to a Nullable<T> of DateTime.
Public operatorStatic memberSupported by Portable Class LibraryExplicit(XElement to Nullable<DateTimeOffset>)Cast the value of this XElement to a Nullable<T> of DateTimeOffset.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<TimeSpan>)Cast the value of this XElement to a Nullable<T> of TimeSpan.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to TimeSpan)Cast the value of this XElement to a TimeSpan.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to DateTime)Cast the value of this XElement to a DateTime.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<Double>)Cast the value of this XElement to a Nullable<T> of Double.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Double)Cast the value of this XElement to a Double.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Guid)Cast the value of this XElement to a Guid.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<Decimal>)Cast the value of this XElement to a Nullable<T> of Decimal.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Decimal)Cast the value of this XElement to a Decimal.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to UInt32)Cast the value of this XElement to a UInt32.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Boolean)Cast the value of this XElement to a Boolean.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to String)Cast the value of this XElement to a String.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<Guid>)Cast the value of this XElement to a Nullable<T> of Guid.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<Int32>)Cast the value of this XElement to a Nullable<T> of Int32.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Int32)Cast the value of this XElement to an Int32.
Public operatorStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryExplicit(XElement to Nullable<Boolean>)Cast the value of this XElement to a Nullable<T> of Boolean.
Top

  NameDescription
Public Extension MethodCreateNavigator()Overloaded. Creates an XPathNavigator for an XNode. (Defined by Extensions.)
Public Extension MethodCreateNavigator(XmlNameTable)Overloaded. Creates an XPathNavigator for an XNode. The XmlNameTable enables more efficient XPath expression processing. (Defined by Extensions.)
Public Extension MethodGetSchemaInfoGets the post-schema-validation infoset (PSVI) of a validated element. (Defined by Extensions.)
Public Extension MethodValidate(XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)Overloaded. This method validates that an XElement sub-tree conforms to a specified XmlSchemaObject and an XmlSchemaSet. (Defined by Extensions.)
Public Extension MethodValidate(XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)Overloaded. Validates that an XElement sub-tree conforms to a specified XmlSchemaObject and an XmlSchemaSet, optionally populating the XML tree with the post-schema-validation infoset (PSVI). (Defined by Extensions.)
Public Extension MethodXPathEvaluate(String)Overloaded. Evaluates an XPath expression. (Defined by Extensions.)
Public Extension MethodXPathEvaluate(String, IXmlNamespaceResolver)Overloaded. Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. (Defined by Extensions.)
Public Extension MethodXPathSelectElement(String)Overloaded. Selects an XElement using a XPath expression. (Defined by Extensions.)
Public Extension MethodXPathSelectElement(String, IXmlNamespaceResolver)Overloaded. Selects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. (Defined by Extensions.)
Public Extension MethodXPathSelectElements(String)Overloaded. Selects a collection of elements using an XPath expression. (Defined by Extensions.)
Public Extension MethodXPathSelectElements(String, IXmlNamespaceResolver)Overloaded. Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. (Defined by Extensions.)
Top

  NameDescription
Explicit interface implemetationPrivate methodSupported by the XNA FrameworkSupported by Portable Class LibraryIXmlLineInfo.HasLineInfoGets a value indicating whether or not this XObject has line information. (Inherited from XObject.)
Explicit interface implemetationPrivate propertySupported by the XNA FrameworkSupported by Portable Class LibraryIXmlLineInfo.LineNumberGets the line number that the underlying XmlReader reported for this XObject. (Inherited from XObject.)
Explicit interface implemetationPrivate propertySupported by the XNA FrameworkSupported by Portable Class LibraryIXmlLineInfo.LinePositionGets the line position that the underlying XmlReader reported for this XObject. (Inherited from XObject.)
Explicit interface implemetationPrivate methodSupported by the XNA FrameworkIXmlSerializable.GetSchemaGets an XML schema definition that describes the XML representation of this object.
Explicit interface implemetationPrivate methodSupported by the XNA FrameworkIXmlSerializable.ReadXmlGenerates an object from its XML representation.
Explicit interface implemetationPrivate methodSupported by the XNA FrameworkIXmlSerializable.WriteXmlConverts an object into its XML representation.
Top

NoteNote

To view the .NET Framework source code for this type, see the Reference Source. You can browse through the source code online, download the reference for offline viewing, and step through the sources (including patches and updates) during debugging; see instructions.

This class represents an XML element, the fundamental XML construct. See XElement Class Overview for other usage information.

An element has an XName, optionally one or more attributes, and can optionally contain content (for more information, see Nodes).

An XElement can contain the following types of content:

For details about the valid content of an XElement, see Valid Content of XElement and XDocument Objects.

XElement derives from XContainer, which derives from XNode.

Some XElement methods can be used from XAML. For more information, see LINQ to XML Dynamic Properties.

The following example creates an XML tree. The content of the new element comes from a LINQ query.

XElement xmlTree1 = new XElement("Root",
    new XElement("Child1", 1),
    new XElement("Child2", 2),
    new XElement("Child3", 3),
    new XElement("Child4", 4),
    new XElement("Child5", 5),
    new XElement("Child6", 6)
);

XElement xmlTree2 = new XElement("Root",
    from el in xmlTree1.Elements()
    where((int)el >= 3 && (int)el <= 5)
    select el
);
Console.WriteLine(xmlTree2);

This example produces the following output:

<Root>
  <Child3>3</Child3>
  <Child4>4</Child4>
  <Child5>5</Child5>
</Root>

The following is the same example, but in this case the XML is in a namespace. For more information, see Working with XML Namespaces.

XNamespace aw = "http://www.adventure-works.com";
XElement xmlTree1 = new XElement(aw + "Root",
    new XElement(aw + "Child1", 1),
    new XElement(aw + "Child2", 2),
    new XElement(aw + "Child3", 3),
    new XElement(aw + "Child4", 4),
    new XElement(aw + "Child5", 5),
    new XElement(aw + "Child6", 6)
);

XElement xmlTree2 = new XElement(aw + "Root",
    from el in xmlTree1.Elements()
    where((int)el >= 3 && (int)el <= 5)
    select el
);
Console.WriteLine(xmlTree2);

This example produces the following output:

<Root xmlns="http://www.adventure-works.com">
  <Child3>3</Child3>
  <Child4>4</Child4>
  <Child5>5</Child5>
</Root>

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2015 Microsoft