Compartilhar via


XElement Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Represents an XML element.

Inheritance Hierarchy

System.Object
  System.Xml.Linq.XObject
    System.Xml.Linq.XNode
      System.Xml.Linq.XContainer
        System.Xml.Linq.XElement

Namespace:  System.Xml.Linq
Assembly:  System.Xml.Linq (in System.Xml.Linq.dll)

Syntax

'Declaration
<XmlSchemaProviderAttribute(Nothing, IsAny := True)> _
Public Class XElement _
    Inherits XContainer _
    Implements IXmlSerializable
[XmlSchemaProviderAttribute(null, IsAny = true)]
public class XElement : XContainer, IXmlSerializable

The XElement type exposes the following members.

Constructors

  Name Description
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 XElement(XElement) Initializes a new instance of the XElement class from another XElement object.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 XElement(XName) Initializes a new instance of the XElement class with the specified name.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 XElement(XStreamingElement) Initializes a new instance of the XElement class from an XStreamingElement object.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 XElement(XName, Object) Initializes a new instance of the XElement class with the specified name and content.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 XElement(XName, array<Object[]) Initializes a new instance of the XElement class with the specified name and content.

Top

Properties

  Name Description
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 BaseUri Gets the base URI for this XObject. (Inherited from XObject.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 Document Gets the XDocument for this XObject. (Inherited from XObject.)
Public propertyStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 EmptySequence Gets an empty collection of elements.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 FirstAttribute Gets the first attribute of this element.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 FirstNode Get the first child node of this node. (Inherited from XContainer.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 HasAttributes Gets a value indicating whether this element as at least one attribute.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 HasElements Gets a value indicating whether this element has at least one child element.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 IsEmpty Gets a value indicating whether this element contains no content.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 LastAttribute Gets the last attribute of this element.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 LastNode Get the last child node of this node. (Inherited from XContainer.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 Name Gets the name of this element.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 NextNode Gets the next sibling node of this node. (Inherited from XNode.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 NodeType Gets the node type for this node. (Overrides XObject.NodeType.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 Parent Gets the parent XElement of this XObject. (Inherited from XObject.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 PreviousNode Gets the previous sibling node of this node. (Inherited from XNode.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 Value Gets the concatenated text contents of this element.

Top

Methods

  Name Description
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Add(Object) Adds the specified content as children of this XContainer. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Add(array<Object[]) Adds the specified content as children of this XContainer. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 AddAfterSelf(Object) Adds the specified content immediately after this node. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 AddAfterSelf(array<Object[]) Adds the specified content immediately after this node. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 AddAnnotation Adds an object to the annotation list of this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 AddBeforeSelf(Object) Adds the specified content immediately before this node. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 AddBeforeSelf(array<Object[]) Adds the specified content immediately before this node. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 AddFirst(Object) Adds the specified content as the first children of this document or element. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 AddFirst(array<Object[]) Adds the specified content as the first children of this document or element. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Ancestors() Returns a collection of the ancestor elements of this node. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 AncestorsAndSelf() Returns a collection of elements that contain this element, and the ancestors of this element.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 AncestorsAndSelf(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 Silverlight for Windows PhoneSupported by Xbox 360 Annotation(Type) Gets the first annotation object of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Annotation<T>() Get the first annotation object of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Annotations(Type) Gets a collection of annotations of the specified type for this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Annotations<T>() Gets a collection of annotations of the specified type for this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Attribute Returns the XAttribute of this XElement that has the specified XName.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Attributes() Returns a collection of attributes of this element.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Attributes(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 Silverlight for Windows PhoneSupported by Xbox 360 CreateReader() Creates an XmlReader for this node. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 CreateReader(ReaderOptions) Creates an XmlReader for this node. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 CreateWriter Creates an XmlWriter that can be used to add nodes to the XContainer. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 DescendantNodes Returns a collection of the descendant nodes for this document or element, in document order. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 DescendantNodesAndSelf Returns a collection of nodes that contain this element, and all descendant nodes of this element, in document order.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Descendants() Returns a collection of the descendant elements for this document or element, in document order. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Descendants(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 Silverlight for Windows PhoneSupported by Xbox 360 DescendantsAndSelf() Returns a collection of elements that contain this element, and all descendant elements of this element, in document order.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 DescendantsAndSelf(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 Silverlight for Windows PhoneSupported by Xbox 360 Element Gets the first (in document order) child element with the specified XName. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Elements() Returns a collection of the child elements of this element or document, in document order. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Elements(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 Silverlight for Windows PhoneSupported by Xbox 360 ElementsAfterSelf() Returns a collection of the sibling elements after this node, in document order. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ElementsBeforeSelf() Returns a collection of the sibling elements before this node, in document order. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 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.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetDefaultNamespace Gets the default XNamespace of this XElement.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetNamespaceOfPrefix Gets the namespace associated with a particular prefix for this XElement.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetPrefixOfNamespace Gets the prefix associated with a namespace for this XElement.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 GetType Gets the Type of the current instance. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 IsAfter Determines if the current node appears after a specified node in terms of document order. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 IsBefore Determines if the current node appears before a specified node in terms of document order. (Inherited from XNode.)
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Load(Stream) Creates a new XElement instance using the specified stream.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Load(String) Loads an XElement from a file located in the applications' XAP package.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Load(TextReader) Loads an XElement from a TextReader.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Load(XmlReader) Loads an XElement from an XmlReader.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Load(Stream, LoadOptions) Creates a new XElement instance using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Load(String, LoadOptions) Loads an XElement from a file located in the application's XAP package, optionally preserving white space, setting the base URI, and retaining line information.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Load(TextReader, LoadOptions) Loads an XElement from a TextReader, optionally preserving white space and retaining line information.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Load(XmlReader, LoadOptions) Loads an XElement from an XmlReader, optionally preserving white space, setting the base URI, and retaining line information.
Protected methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Nodes Returns a collection of the child nodes of this element or document, in document order. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 NodesAfterSelf Returns a collection of the sibling nodes after this node, in document order. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 NodesBeforeSelf Returns a collection of the sibling nodes before this node, in document order. (Inherited from XNode.)
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Parse(String) Load an XElement from a string that contains XML.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Parse(String, LoadOptions) Load an XElement from a string that contains XML, optionally preserving white space and retaining line information.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Remove Removes this node from its parent. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 RemoveAll Removes nodes and attributes from this XElement.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 RemoveAnnotations(Type) Removes the annotations of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 RemoveAnnotations<T>() Removes the annotations of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 RemoveAttributes Removes the attributes of this XElement.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 RemoveNodes Removes the child nodes from this document or element. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ReplaceAll(Object) Replaces the child nodes and the attributes of this element with the specified content.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ReplaceAll(array<Object[]) Replaces the child nodes and the attributes of this element with the specified content.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ReplaceAttributes(Object) Replaces the attributes of this element with the specified content.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ReplaceAttributes(array<Object[]) Replaces the attributes of this element with the specified content.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ReplaceNodes(Object) Replaces the children nodes of this document or element with the specified content. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ReplaceNodes(array<Object[]) Replaces the children nodes of this document or element with the specified content. (Inherited from XContainer.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ReplaceWith(Object) Replaces this node with the specified content. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ReplaceWith(array<Object[]) Replaces this node with the specified content. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Save(Stream) Outputs this XElement to the specified Stream.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Save(TextWriter) Serialize this element to a TextWriter.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Save(XmlWriter) Serialize this element to an XmlWriter.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Save(Stream, SaveOptions) Outputs this XElement to the specified Stream, optionally specifying formatting behavior.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 Save(TextWriter, SaveOptions) Serialize this element to a TextWriter, optionally disabling formatting.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 SetAttributeValue Sets the value of an attribute, adds an attribute, or removes an attribute.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 SetElementValue Sets the value of a child element, adds a child element, or removes a child element.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 SetValue Sets the value of this element.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ToString() Returns the indented XML for this node. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 ToString(SaveOptions) Returns the XML for this node, optionally disabling formatting. (Inherited from XNode.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 WriteTo Write this element to an XmlWriter. (Overrides XNode.WriteTo(XmlWriter).)

Top

Events

  Name Description
Public eventSupported by Silverlight for Windows PhoneSupported by Xbox 360 Changed Raised when this XObject or any of its descendants have changed. (Inherited from XObject.)
Public eventSupported by Silverlight for Windows PhoneSupported by Xbox 360 Changing Raised when this XObject or any of its descendants are about to change. (Inherited from XObject.)

Top

Operators

  Name Description
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to DateTime) Cast the value of this XElement to a DateTime.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Decimal) Cast the value of this XElement to a Decimal.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<Decimal>) Cast the value of this XElement to a Nullable<T> of Decimal.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<Single>) Cast the value of this XElement to a Nullable<T> of Single.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to TimeSpan) Cast the value of this XElement to a TimeSpan.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<Double>) Cast the value of this XElement to a Nullable<T> of Double.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Double) Cast the value of this XElement to a Double.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Single) Cast the value of this XElement to a Single.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Guid) Cast the value of this XElement to a Guid.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<Guid>) Cast the value of this XElement to a Nullable<T> of Guid.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<TimeSpan>) Cast the value of this XElement to a Nullable<T> of TimeSpan.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<DateTime>) Cast the value of this XElement to a Nullable<T> of DateTime.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to DateTimeOffset) Cast the value of this XAttribute to a DateTimeOffset.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<DateTimeOffset>) Cast the value of this XElement to a Nullable<T> of DateTimeOffset.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Int32) Cast the value of this XElement to an Int32.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<Int32>) Cast the value of this XElement to a Nullable<T> of Int32.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<Boolean>) Cast the value of this XElement to a Nullable<T> of Boolean.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to String) Cast the value of this XElement to a String.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Boolean) Cast the value of this XElement to a Boolean.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to UInt32) Cast the value of this XElement to a UInt32.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to UInt64) Cast the value of this XElement to a UInt64.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<UInt64>) Cast the value of this XElement to a Nullable<T> of UInt64.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<Int64>) Cast the value of this XElement to a Nullable<T> of Int64.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Nullable<UInt32>) Cast the value of this XElement to a Nullable<T> of UInt32.
Public operatorStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360 Explicit(XElement to Int64) Cast the value of this XElement to an Int64.

Top

Extension Methods

  Name Description
Public Extension Method CreateNavigator() Overloaded. Creates an XPathNavigator for an XNode. (Defined by Extensions.)
Public Extension Method CreateNavigator(XmlNameTable) Overloaded. Creates an XPathNavigator for an XNode. The XmlNameTable enables more efficient XPath expression processing. (Defined by Extensions.)
Public Extension Method XPathEvaluate(String) Overloaded. Evaluates an XPath expression. (Defined by Extensions.)
Public Extension Method XPathEvaluate(String, IXmlNamespaceResolver) Overloaded. Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. (Defined by Extensions.)
Public Extension Method XPathSelectElement(String) Overloaded. Selects an XElement using a XPath expression. (Defined by Extensions.)
Public Extension Method XPathSelectElement(String, IXmlNamespaceResolver) Overloaded. Selects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. (Defined by Extensions.)
Public Extension Method XPathSelectElements(String) Overloaded. Selects a collection of elements using an XPath expression. (Defined by Extensions.)
Public Extension Method XPathSelectElements(String, IXmlNamespaceResolver) Overloaded. Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. (Defined by Extensions.)

Top

Explicit Interface Implementations

  Name Description
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 IXmlLineInfo.HasLineInfo Gets a value indicating whether or not this XObject has line information. (Inherited from XObject.)
Explicit interface implemetationPrivate propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 IXmlLineInfo.LineNumber Gets the line number that the underlying XmlReader reported for this XObject. (Inherited from XObject.)
Explicit interface implemetationPrivate propertySupported by Silverlight for Windows PhoneSupported by Xbox 360 IXmlLineInfo.LinePosition Gets the line position that the underlying XmlReader reported for this XObject. (Inherited from XObject.)
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 IXmlSerializable.GetSchema Gets an XML schema definition that describes the XML representation of this object.
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 IXmlSerializable.ReadXml Generates an object from its XML representation.
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows PhoneSupported by Xbox 360 IXmlSerializable.WriteXml Converts an object into its XML representation.

Top

Remarks

This class represents an XML element, the fundamental XML construct.

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 more information about the valid content of an XElement, see Valid Content of XElement and XDocument Objects in the .NET Framework documentation.

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 in the .NET Framework documentation.

Examples

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

Dim output As New StringBuilder
Dim xmlTree1 As XElement = _
        <Root>
            <Child1>1</Child1>
            <Child2>2</Child2>
            <Child3>3</Child3>
            <Child4>4</Child4>
            <Child5>5</Child5>
            <Child6>6</Child6>
        </Root>

Dim xmlTree2 As XElement = _
    <Root>
        <%= From el In xmlTree1.Elements() _
            Where el.Value >= 3 And el.Value <= 5 _
            Select el %>
    </Root>

output.Append(xmlTree2)
output.Append(Environment.NewLine)


OutputTextBlock.Text = output.ToString()
StringBuilder output = new StringBuilder();
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
);
output.Append(xmlTree2 + Environment.NewLine);

OutputTextBlock.Text = output.ToString();

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

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