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 ver los componentes y el uso de un objeto XDocument, consulte Información general acerca de la clase XDocument.

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)

Este ejemplo produce el siguiente resultado:

<!--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 objetos XElement y 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 la clase XDeclaration y el contenido especificados.
XDocument(XDocument)

Inicializa una nueva instancia de la clase XDocument a partir de un objeto XDocument ya 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 objeto XDocument para este objeto 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 de este nodo.
Parent

Obtiene el XElement primario de XObject.

(Heredado de XObject)
PreviousNode

Obtiene el anterior nodo relacionado 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 a continuación de este nodo.

(Heredado de XNode)
AddAfterSelf(Object[])

Agrega el contenido especificado inmediatamente a continuación de este nodo.

(Heredado de XNode)
AddAnnotation(Object)

Agrega un objeto a la lista de anotaciones de 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 el primer elemento secundario de este documento o elemento.

(Heredado de XContainer)
AddFirst(Object[])

Agrega el contenido especificado como el primer elemento secundario 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 sólo se incluyen los elementos que tienen un objeto 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 objeto XmlReader para este nodo.

(Heredado de XNode)
CreateReader(ReaderOptions)

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

(Heredado de XNode)
CreateWriter()

Crea un objeto XmlWriter que se puede utilizar para agregar los nodos a XContainer.

(Heredado de XContainer)
DescendantNodes()

Devuelve una colección de los nodos descendientes de este documento o elemento, clasificados por documento.

(Heredado de XContainer)
Descendants()

Devuelve una colección de los elementos descendientes de este documento o elemento, clasificados por documento.

(Heredado de XContainer)
Descendants(XName)

Devuelve una colección filtrada de los elementos descendientes de este documento o elemento, clasificados por documento. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.

(Heredado de XContainer)
Element(XName)

Obtiene el primer elemento secundario (clasificado por documento) con el XName especificado.

(Heredado de XContainer)
Elements()

Devuelve una colección de los elementos secundarios de este elemento o documento, clasificados por documento.

(Heredado de XContainer)
Elements(XName)

Devuelve una colección filtrada de elementos secundarios de este documento o elemento, clasificados por documento. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.

(Heredado de XContainer)
ElementsAfterSelf()

Devuelve una colección de los elementos relacionados situados detrás de este nodo en el orden del documento.

(Heredado de XNode)
ElementsAfterSelf(XName)

Devuelve una colección filtrada de los elementos relacionados situados detrás de este nodo en el orden del documento. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.

(Heredado de XNode)
ElementsBeforeSelf()

Devuelve una colección de los elementos relacionados situados antes de este nodo en el orden del documento.

(Heredado de XNode)
ElementsBeforeSelf(XName)

Devuelve una colección filtrada de los elementos relacionados situados antes de este nodo en el orden del documento. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.

(Heredado de XNode)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la 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 respecto al orden del documento.

(Heredado de XNode)
IsBefore(XNode)

Determina si el nodo actual aparece antes de un nodo especificado respecto al orden del documento.

(Heredado de XNode)
Load(Stream)

Crea una nueva instancia de XDocument usando la secuencia especificada.
Load(Stream, LoadOptions)

Crea una nueva instancia de XDocument usando la secuencia especificada y, de forma opcional, conservando el espacio en blanco, estableciendo el identificador URI base y conservando la información de línea.
Load(String)

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

Crea un nuevo XDocument a partir de un archivo y, de manera opcional, conserva el espacio en blanco, establece el URI base y retiene la información de línea.
Load(TextReader)

Crea una nueva clase de XDocument a partir de TextReader.
Load(TextReader, LoadOptions)

Crea un nuevo XDocument a partir de un TextReader y, de manera opcional, conserva el espacio en blanco, establece el URI base y retiene la información de línea.
Load(XmlReader)

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

Carga un XDocument desde un XmlReader y, de manera opcional, se establece el URI base y se retiene la información de línea.
LoadAsync(Stream, LoadOptions, CancellationToken)

Crea de forma asincrónica un nuevo objeto XDocument e inicializa su árbol XML subyacente a partir del flujo especificado y, de manera opcional, conserva el espacio en blanco.
LoadAsync(TextReader, LoadOptions, CancellationToken)

Crea un nuevo objeto XDocument e inicializa su árbol XML subyacente mediante el parámetro TextReader especificado y, de manera opcional, conserva el espacio en blanco.
LoadAsync(XmlReader, LoadOptions, CancellationToken)

Crea un nuevo objeto XDocument que incluye el contenido del objeto XmlReader especificado.
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
Nodes()

Devuelve una colección de los nodos secundarios de este elemento o documento, clasificados por documento.

(Heredado de XContainer)
NodesAfterSelf()

Devuelve una colección de los nodos relacionados situados detrás de este nodo en el orden del documento.

(Heredado de XNode)
NodesBeforeSelf()

Devuelve una colección de los nodos relacionados situados antes de este nodo en el orden del documento.

(Heredado de XNode)
Parse(String)

Crea un nuevo XDocument a partir de una cadena.
Parse(String, LoadOptions)

Crea un objeto XDocument nuevo a partir de una cadena, opcionalmente se conserva el espacio en blanco, se establece el URI base y la información de línea.
Remove()

Quita este nodo de su elemento primario.

(Heredado de XNode)
RemoveAnnotations(Type)

Quita las anotaciones del tipo especificado de XObject.

(Heredado de XObject)
RemoveAnnotations<T>()

Quita las anotaciones del tipo especificado de 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)

Genera este XDocument en el objeto Stream especificado.
Save(Stream, SaveOptions)

Genera este XDocument en el objeto Stream especificado, especificando opcionalmente el comportamiento de formato.
Save(String)

Serializa este XDocument en un archivo, sobrescribiendo un archivo existente, si existe.
Save(String, SaveOptions)

Serializa XDocument en un archivo, opcionalmente se deshabilita el formato.
Save(TextWriter)

Serializa el XDocument en un TextWriter.
Save(TextWriter, SaveOptions)

Serializa el XDocument en un TextWriter, opcionalmente se deshabilita el formato.
Save(XmlWriter)

Serializa el XDocument en un XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)

Genera esta clase XDocument en un escritor Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)

Escribe esta clase XDocument en un escritor TextWriter.
SaveAsync(XmlWriter, CancellationToken)

Escribe esta clase XDocument en un escritor XmlWriter.
ToString()

Devuelve el XML con sangría para este nodo.

(Heredado de XNode)
ToString(SaveOptions)

Devuelve el XML de este nodo y, opcionalmente, deshabilita el formato.

(Heredado de XNode)
WriteTo(XmlWriter)

Escribe el documento en un objeto XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)

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

Escribe el nodo actual en XmlWriter.

(Heredado de XNode)

Eventos

Changed

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

(Heredado de XObject)
Changing

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

(Heredado de XObject)

Implementaciones de interfaz explícitas

IXmlLineInfo.HasLineInfo()

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

(Heredado de XObject)
IXmlLineInfo.LineNumber

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

(Heredado de XObject)
IXmlLineInfo.LinePosition

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

(Heredado de XObject)

Métodos de extensión

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)

Este método valida que un XDocument se ajusta a un XSD en un XmlSchemaSet.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)

Valida que XDocument se ajusta a XSD en XmlSchemaSet y, de manera opcional, rellena el árbol XML con el conjunto de información posterior a la validación del esquema (PSVI).
CreateNavigator(XNode)

Crea un objeto XPathNavigator para XNode.
CreateNavigator(XNode, XmlNameTable)

Crea un objeto XPathNavigator para XNode. XmlNameTable permite un procesamiento más eficaz de la expresión XPath.
XPathEvaluate(XNode, String)

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

Evalúa una expresión XPath, resolviendo los prefijos de espacio de nombres mediante el IXmlNamespaceResolver especificado.
XPathSelectElement(XNode, String)

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

Selecciona un XElement utilizando una expresión XPath, que resuelve los prefijos de espacio de nombres mediante el IXmlNamespaceResolver especificado.
XPathSelectElements(XNode, String)

Selecciona una colección de elementos mediante una expresión XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Selecciona una colección de elementos utilizando una expresión XPath, que resuelve los prefijos de espacio de nombres mediante el IXmlNamespaceResolver especificado.
ToXPathNavigable(XNode)

Devuelve un descriptor de acceso que permite navegar y editar el elemento XNode especificado.

Se aplica a

Consulte también