XDocument Clase

Definición

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

Representa un documento XML. Para ver los componentes y el uso de un XDocument objeto, vea Información general sobre 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 XElement y objetos XDocument.

Constructores

Nombre Description
XDocument()

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

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

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

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

Propiedades

Nombre Description
BaseUri

Obtiene el URI base de este XObjectobjeto .

(Heredado de XObject)
Declaration

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

Obtiene para XDocument este XObjectobjeto .

(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 elemento primario XElement de este XObjectobjeto .

(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

Nombre Description
Add(Object)

Agrega el contenido especificado como elementos secundarios de este XContainerobjeto .

(Heredado de XContainer)
Add(Object[])

Agrega el contenido especificado como elementos secundarios de este XContainerobjeto .

(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 XObjectobjeto .

(Heredado de XObject)
Annotation<T>()

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

(Heredado de XObject)
Annotations(Type)

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

(Heredado de XObject)
Annotations<T>()

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

(Heredado de XObject)
CreateReader()

Crea un XmlReader para este nodo.

(Heredado de XNode)
CreateReader(ReaderOptions)

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

(Heredado de XNode)
CreateWriter()

Crea un XmlWriter objeto que se puede usar para agregar nodos a .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 especificado XName.

(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 XDocument instancia mediante la secuencia especificada, conservando opcionalmente el espacio en blanco, estableciendo el URI base y conservando la información de línea.
Load(Stream)

Crea una nueva XDocument instancia mediante el flujo especificado.
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 .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 .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 especificado TextReader , conservando opcionalmente el espacio en blanco.
LoadAsync(XmlReader, LoadOptions, CancellationToken)

Crea un nuevo XDocument objeto que contiene el contenido del objeto especificado XmlReader.
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 esto XDocument en el especificado Streamy, opcionalmente, especifica el comportamiento de formato.
Save(Stream)

Genera esto XDocument en el especificado Stream.
Save(String, SaveOptions)

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

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

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

Serialice esto XDocument en un TextWriter.
Save(XmlWriter)

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

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

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

Escribe esto 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 .XmlWriter
WriteToAsync(XmlWriter, CancellationToken)

Escribe el árbol XML subyacente de este XDocument en el especificado XmlWriter.

Eventos

Nombre Description
Changed

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

(Heredado de XObject)
Changing

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

(Heredado de XObject)

Implementaciones de interfaz explícitas

Nombre Description
IXmlLineInfo.HasLineInfo()

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

(Heredado de XObject)
IXmlLineInfo.LineNumber

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

(Heredado de XObject)
IXmlLineInfo.LinePosition

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

(Heredado de XObject)

Métodos de extensión

Nombre Description
CreateNavigator(XNode, XmlNameTable)

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

Crea un XPathNavigator para un XNodeobjeto .
ToXPathNavigable(XNode)

Devuelve un descriptor de acceso que permite navegar y editar el especificado XNode.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)

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

Este método valida que un XDocument objeto se ajusta a un XSD en un XmlSchemaSet.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)

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

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

Selecciona un XElement objeto mediante una expresión XPath, resolviendo prefijos de espacio de nombres mediante el especificado IXmlNamespaceResolver.
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 especificado IXmlNamespaceResolver.
XPathSelectElements(XNode, String)

Selecciona una colección de elementos mediante una expresión XPath.

Se aplica a

Consulte también