XDocument Clase

  • Referencia

Definición

Espacio de nombres:
System.Xml.Linq
Ensamblado:
System.Xml.XDocument.dll
Ensamblado:
System.Xml.Linq.dll
Ensamblado:
netstandard.dll
Source:
XDocument.cs
Source:
XDocument.cs
Source:
XDocument.cs

Representa un documento XML. Para conocer los componentes y el uso de un objeto de XDocument, vea XDocument Class Overview.

public ref class XDocument : System::Xml::Linq::XContainer
public class XDocument : System.Xml.Linq.XContainer
type XDocument = class
    inherit XContainer
Public Class XDocument
Inherits XContainer
Herencia
Object
XObject
XNode
XContainer
XDocument

Ejemplos

En el ejemplo siguiente se crea un documento y, a continuación, se agrega un comentario y un elemento a él. A continuación, compone otro documento mediante los resultados de una consulta.

XDocument srcTree = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        new XElement("Child1", "data1"),
        new XElement("Child2", "data2"),
        new XElement("Child3", "data3"),
        new XElement("Child2", "data4"),
        new XElement("Info5", "info5"),
        new XElement("Info6", "info6"),
        new XElement("Info7", "info7"),
        new XElement("Info8", "info8")
    )
);

XDocument doc = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        from el in srcTree.Element("Root").Elements()
        where ((string)el).StartsWith("data")
        select el
    )
);
Console.WriteLine(doc);

Dim srcTree As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <Child1>data1</Child1>
            <Child2>data2</Child2>
            <Child3>data3</Child3>
            <Child2>data4</Child2>
            <Info5>info5</Info5>
            <Info6>info6</Info6>
            <Info7>info7</Info7>
            <Info8>info8</Info8>
        </Root>
Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <%= From el In srcTree.<Root>.Elements _
                Where CStr(el).StartsWith("data") _
                Select el %>
        </Root>
Console.WriteLine(doc)

En este ejemplo se genera la siguiente salida:

<!--This is a comment-->
<Root>
  <Child1>data1</Child1>
  <Child2>data2</Child2>
  <Child3>data3</Child3>
  <Child2>data4</Child2>
</Root>

Comentarios

Para obtener más información sobre el contenido válido de un XDocument, vea Contenido válido de XElement y objetos XDocument.

Constructores

XDocument()

Inicializa una nueva instancia de la clase XDocument.
XDocument(Object[])

Inicializa una nueva instancia de la clase XDocument con el contenido especificado.
XDocument(XDeclaration, Object[])

Inicializa una nueva instancia de la clase XDocument con el contenido y el XDeclaration especificados.
XDocument(XDocument)

Inicializa una nueva instancia de la clase XDocument a partir de un objeto XDocument existente.

Propiedades

BaseUri

Obtiene el URI base de este XObject.

(Heredado de XObject)
Declaration

Obtiene o establece la declaración XML de este documento.
Document

Obtiene el XDocument de este XObject.

(Heredado de XObject)
DocumentType

Obtiene la definición de tipo de documento (DTD) de este documento.
FirstNode

Obtiene el primer nodo secundario de este nodo.

(Heredado de XContainer)
LastNode

Obtiene el último nodo secundario de este nodo.

(Heredado de XContainer)
NextNode

Obtiene el siguiente nodo relacionado de este nodo.

(Heredado de XNode)
NodeType

Obtiene el tipo de nodo para este nodo.
Parent

Obtiene el XElement primario de este XObject.

(Heredado de XObject)
PreviousNode

Obtiene el nodo relacionado anterior de este nodo.

(Heredado de XNode)
Root

Obtiene el elemento raíz del árbol XML de este documento.

Métodos

Add(Object)

Agrega el contenido especificado como elementos secundarios de este XContainer.

(Heredado de XContainer)
Add(Object[])

Agrega el contenido especificado como elementos secundarios de este XContainer.

(Heredado de XContainer)
AddAfterSelf(Object)

Agrega el contenido especificado inmediatamente después de este nodo.

(Heredado de XNode)
AddAfterSelf(Object[])

Agrega el contenido especificado inmediatamente después de este nodo.

(Heredado de XNode)
AddAnnotation(Object)

Agrega un objeto a la lista de anotaciones de este XObject.

(Heredado de XObject)
AddBeforeSelf(Object)

Agrega el contenido especificado inmediatamente antes de este nodo.

(Heredado de XNode)
AddBeforeSelf(Object[])

Agrega el contenido especificado inmediatamente antes de este nodo.

(Heredado de XNode)
AddFirst(Object)

Agrega el contenido especificado como los primeros elementos secundarios de este documento o elemento.

(Heredado de XContainer)
AddFirst(Object[])

Agrega el contenido especificado como los primeros elementos secundarios de este documento o elemento.

(Heredado de XContainer)
Ancestors()

Devuelve una colección de los elementos antecesores de este nodo.

(Heredado de XNode)
Ancestors(XName)

Devuelve una colección filtrada de los elementos antecesores de este nodo. En la colección solo se incluyen los elementos que tienen una XName coincidente.

(Heredado de XNode)
Annotation(Type)

Obtiene el primer objeto de anotación del tipo especificado de este XObject.

(Heredado de XObject)
Annotation<T>()

Obtiene el primer objeto de anotación del tipo especificado de este XObject.

(Heredado de XObject)
Annotations(Type)

Obtiene una colección de anotaciones del tipo especificado para este XObject.

(Heredado de XObject)
Annotations<T>()

Obtiene una colección de anotaciones del tipo especificado para este XObject.

(Heredado de XObject)
CreateReader()

Crea un XmlReader para este nodo.

(Heredado de XNode)
CreateReader(ReaderOptions)

Crea un XmlReader con las opciones especificadas por el parámetro readerOptions.

(Heredado de XNode)
CreateWriter()

Crea un XmlWriter que se puede usar para agregar nodos al XContainer.

(Heredado de XContainer)
DescendantNodes()

Devuelve una colección de los nodos descendientes de este documento o elemento, en orden de documento.

(Heredado de XContainer)
Descendants()

Devuelve una colección de los elementos descendientes de este documento o elemento, en orden de documento.

(Heredado de XContainer)
Descendants(XName)

Devuelve una colección filtrada de los elementos descendientes de este documento o elemento, en orden de documento. En la colección solo se incluyen los elementos que tienen una XName coincidente.

(Heredado de XContainer)
Element(XName)

Obtiene el primer elemento secundario (en orden de documento) con el XNameespecificado.

(Heredado de XContainer)
Elements()

Devuelve una colección de los elementos secundarios de este elemento o documento, en orden de documento.

(Heredado de XContainer)
Elements(XName)

Devuelve una colección filtrada de los elementos secundarios de este elemento o documento, en orden de documento. En la colección solo se incluyen los elementos que tienen una XName coincidente.

(Heredado de XContainer)
ElementsAfterSelf()

Devuelve una colección de los elementos del mismo nivel después de este nodo, en orden de documento.

(Heredado de XNode)
ElementsAfterSelf(XName)

Devuelve una colección filtrada de los elementos del mismo nivel después de este nodo, en orden de documento. En la colección solo se incluyen los elementos que tienen una XName coincidente.

(Heredado de XNode)
ElementsBeforeSelf()

Devuelve una colección de los elementos del mismo nivel antes de este nodo, en orden de documento.

(Heredado de XNode)
ElementsBeforeSelf(XName)

Devuelve una colección filtrada de los elementos del mismo nivel antes de este nodo, en orden de documento. En la colección solo se incluyen los elementos que tienen una XName coincidente.

(Heredado de XNode)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
IsAfter(XNode)

Determina si el nodo actual aparece después de un nodo especificado en términos de orden de documento.

(Heredado de XNode)
IsBefore(XNode)

Determina si el nodo actual aparece antes de un nodo especificado en términos de orden de documento.

(Heredado de XNode)
Load(Stream, LoadOptions)

Crea una nueva instancia de XDocument mediante el flujo especificado, conservando opcionalmente el espacio en blanco, estableciendo el URI base y conservando la información de línea.
Load(Stream)

Crea una nueva instancia de XDocument mediante la secuencia especificada.
Load(String, LoadOptions)

Crea un nuevo XDocument a partir de un archivo, conservando opcionalmente el espacio en blanco, estableciendo el URI base y conservando la información de línea.
Load(String)

Crea un nuevo XDocument a partir de un archivo.
Load(TextReader, LoadOptions)

Crea un nuevo XDocument a partir de un TextReader, conservando opcionalmente el espacio en blanco, estableciendo el URI base y conservando la información de línea.
Load(TextReader)

Crea un nuevo XDocument a partir de un TextReader.
Load(XmlReader, LoadOptions)

Carga un XDocument desde un XmlReader, si lo desea, establece el URI base y conserva la información de línea.
Load(XmlReader)

Crea un nuevo XDocument a partir de un XmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)

Crea de forma asincrónica un nuevo XDocument e inicializa su árbol XML subyacente a partir de la secuencia especificada, conservando opcionalmente el espacio en blanco.
LoadAsync(TextReader, LoadOptions, CancellationToken)

Crea un nuevo XDocument e inicializa su árbol XML subyacente mediante el parámetro TextReader especificado, conservando opcionalmente el espacio en blanco.
LoadAsync(XmlReader, LoadOptions, CancellationToken)

Crea un nuevo XDocument que contiene el contenido del XmlReaderespecificado.
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
Nodes()

Devuelve una colección de los nodos secundarios de este elemento o documento, en orden de documento.

(Heredado de XContainer)
NodesAfterSelf()

Devuelve una colección de los nodos del mismo nivel después de este nodo, en orden de documento.

(Heredado de XNode)
NodesBeforeSelf()

Devuelve una colección de los nodos del mismo nivel antes de este nodo, en orden de documento.

(Heredado de XNode)
Parse(String, LoadOptions)

Crea un nuevo XDocument a partir de una cadena, conservando opcionalmente el espacio en blanco, estableciendo el URI base y conservando la información de línea.
Parse(String)

Crea un nuevo XDocument a partir de una cadena.
Remove()

Quita este nodo de su elemento primario.

(Heredado de XNode)
RemoveAnnotations(Type)

Quita las anotaciones del tipo especificado de este XObject.

(Heredado de XObject)
RemoveAnnotations<T>()

Quita las anotaciones del tipo especificado de este XObject.

(Heredado de XObject)
RemoveNodes()

Quita los nodos secundarios de este documento o elemento.

(Heredado de XContainer)
ReplaceNodes(Object)

Reemplaza los nodos secundarios de este documento o elemento por el contenido especificado.

(Heredado de XContainer)
ReplaceNodes(Object[])

Reemplaza los nodos secundarios de este documento o elemento por el contenido especificado.

(Heredado de XContainer)
ReplaceWith(Object)

Reemplaza este nodo por el contenido especificado.

(Heredado de XNode)
ReplaceWith(Object[])

Reemplaza este nodo por el contenido especificado.

(Heredado de XNode)
Save(Stream, SaveOptions)

Genera este XDocument al Streamespecificado, especificando opcionalmente el comportamiento de formato.
Save(Stream)

Genera este XDocument en el Streamespecificado.
Save(String, SaveOptions)

Serialice este XDocument en un archivo, deshabilitando opcionalmente el formato.
Save(String)

Serialice este XDocument en un archivo, sobrescribiendo un archivo existente, si existe.
Save(TextWriter, SaveOptions)

Serialice este XDocument en un TextWriter, deshabilitando opcionalmente el formato.
Save(TextWriter)

Serialice este XDocument en un TextWriter.
Save(XmlWriter)

Serialice este XDocument en un XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)

Genera este XDocument en un Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)

Escribe este XDocument en un TextWriter.
SaveAsync(XmlWriter, CancellationToken)

Escribe este XDocument en un XmlWriter.
ToString()

Devuelve el XML con sangría para este nodo.

(Heredado de XNode)
ToString(SaveOptions)

Devuelve el XML de este nodo, deshabilitando opcionalmente el formato.

(Heredado de XNode)
WriteTo(XmlWriter)

Escriba este documento en un XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)

Escribe el árbol XML subyacente de este XDocument en el XmlWriterespecificado.
WriteToAsync(XmlWriter, CancellationToken)

Escribe el nodo actual en un XmlWriter.

(Heredado de XNode)

Eventos

Changed

Se genera cuando este XObject o cualquiera de sus descendientes han cambiado.

(Heredado de XObject)
Changing

Se genera cuando este XObject o cualquiera de sus descendientes están a punto de cambiar.

(Heredado de XObject)

Implementaciones de interfaz explícitas

IXmlLineInfo.HasLineInfo()

Obtiene un valor que indica si este XObject tiene información de línea.

(Heredado de XObject)
IXmlLineInfo.LineNumber

Obtiene el número de línea que indica el XmlReader subyacente para este XObject.

(Heredado de XObject)
IXmlLineInfo.LinePosition

Obtiene la posición de línea que indica el XmlReader subyacente para este XObject.

(Heredado de XObject)

Métodos de extensión

Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)

Valida que un XDocument se ajusta a un XSD en un XmlSchemaSet, rellenando opcionalmente el árbol XML con el conjunto de información posterior a la validación de esquemas (PSVI).
Validate(XDocument, XmlSchemaSet, ValidationEventHandler)

Este método valida que un XDocument se ajusta a un XSD en un XmlSchemaSet.
CreateNavigator(XNode, XmlNameTable)

Crea un XPathNavigator para un XNode. El XmlNameTable permite un procesamiento de expresiones XPath más eficaz.
CreateNavigator(XNode)

Crea un XPathNavigator para un XNode.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Evalúa una expresión XPath, resolviendo prefijos de espacio de nombres mediante el IXmlNamespaceResolverespecificado.
XPathEvaluate(XNode, String)

Evalúa una expresión XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Selecciona un XElement mediante una expresión XPath, resolviendo prefijos de espacio de nombres mediante el IXmlNamespaceResolverespecificado.
XPathSelectElement(XNode, String)

Selecciona un XElement mediante una expresión XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Selecciona una colección de elementos mediante una expresión XPath, resolviendo prefijos de espacio de nombres mediante el IXmlNamespaceResolverespecificado.
XPathSelectElements(XNode, String)

Selecciona una colección de elementos mediante una expresión XPath.
ToXPathNavigable(XNode)

Devuelve un descriptor de acceso que permite navegar y editar el XNodeespecificado.

Se aplica a

Consulte también