XDocument Clase

Definición

Representa un documento XML.Represents an XML document. Para ver los componentes y el uso de un objeto XDocument, consulte Información general acerca de la clase XDocument.For the components and usage of an XDocument object, see 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

Ejemplos

En el ejemplo siguiente se crea un documento y, a continuación, se agrega un comentario y un elemento.The following example creates a document, and then adds a comment and an element to it. A continuación, se compone otro documento con los resultados de una consulta.It then composes another document using the results of a query.

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 example produces the following output:

<!--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.For details about the valid content of an XDocument, see Valid Content of XElement and XDocument Objects.

Constructores

XDocument()

Inicializa una nueva instancia de la clase XDocument.Initializes a new instance of the XDocument class.

XDocument(Object[])

Inicializa una nueva instancia de la clase XDocument con el contenido especificado.Initializes a new instance of the XDocument class with the specified content.

XDocument(XDeclaration, Object[])

Inicializa una nueva instancia de la clase XDocument con la clase XDeclaration y el contenido especificados.Initializes a new instance of the XDocument class with the specified XDeclaration and content.

XDocument(XDocument)

Inicializa una nueva instancia de la clase XDocument a partir de un objeto XDocument ya existente.Initializes a new instance of the XDocument class from an existing XDocument object.

Propiedades

BaseUri

Obtiene el URI base de este XObject.Gets the base URI for this XObject.

(Heredado de XObject)
Declaration

Obtiene o establece la declaración XML de este documento.Gets or sets the XML declaration for this document.

Document

Obtiene el objeto XDocument para este objeto XObject.Gets the XDocument for this XObject.

(Heredado de XObject)
DocumentType

Obtiene la definición de tipo de documento (DTD) de este documento.Gets the Document Type Definition (DTD) for this document.

FirstNode

Obtiene el primer nodo secundario de este nodo.Gets the first child node of this node.

(Heredado de XContainer)
LastNode

Obtiene el último nodo secundario de este nodo.Gets the last child node of this node.

(Heredado de XContainer)
NextNode

Obtiene el siguiente nodo relacionado de este nodo.Gets the next sibling node of this node.

(Heredado de XNode)
NodeType

Obtiene el tipo de nodo de este nodo.Gets the node type for this node.

Parent

Obtiene el XElement primario de XObject.Gets the parent XElement of this XObject.

(Heredado de XObject)
PreviousNode

Obtiene el anterior nodo relacionado de este nodo.Gets the previous sibling node of this node.

(Heredado de XNode)
Root

Obtiene el elemento raíz del árbol XML de este documento.Gets the root element of the XML Tree for this document.

Métodos

Add(Object)

Agrega el contenido especificado como elementos secundarios de este XContainer.Adds the specified content as children of this XContainer.

(Heredado de XContainer)
Add(Object[])

Agrega el contenido especificado como elementos secundarios de este XContainer.Adds the specified content as children of this XContainer.

(Heredado de XContainer)
AddAfterSelf(Object)

Agrega el contenido especificado inmediatamente a continuación de este nodo.Adds the specified content immediately after this node.

(Heredado de XNode)
AddAfterSelf(Object[])

Agrega el contenido especificado inmediatamente a continuación de este nodo.Adds the specified content immediately after this node.

(Heredado de XNode)
AddAnnotation(Object)

Agrega un objeto a la lista de anotaciones de XObject.Adds an object to the annotation list of this XObject.

(Heredado de XObject)
AddBeforeSelf(Object)

Agrega el contenido especificado inmediatamente antes de este nodo.Adds the specified content immediately before this node.

(Heredado de XNode)
AddBeforeSelf(Object[])

Agrega el contenido especificado inmediatamente antes de este nodo.Adds the specified content immediately before this node.

(Heredado de XNode)
AddFirst(Object)

Agrega el contenido especificado como el primer elemento secundario de este documento o elemento.Adds the specified content as the first children of this document or element.

(Heredado de XContainer)
AddFirst(Object[])

Agrega el contenido especificado como el primer elemento secundario de este documento o elemento.Adds the specified content as the first children of this document or element.

(Heredado de XContainer)
Ancestors()

Devuelve una colección de los elementos antecesores de este nodo.Returns a collection of the ancestor elements of this node.

(Heredado de XNode)
Ancestors(XName)

Devuelve una colección filtrada de los elementos antecesores de este nodo.Returns a filtered collection of the ancestor elements of this node. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

(Heredado de XNode)
Annotation(Type)

Obtiene el primer objeto de anotación del tipo especificado de este XObject.Gets the first annotation object of the specified type from this XObject.

(Heredado de XObject)
Annotation<T>()

Obtiene el primer objeto de anotación del tipo especificado de este XObject.Gets the first annotation object of the specified type from this XObject.

(Heredado de XObject)
Annotations(Type)

Obtiene una colección de anotaciones del tipo especificado para este XObject.Gets a collection of annotations of the specified type for this XObject.

(Heredado de XObject)
Annotations<T>()

Obtiene una colección de anotaciones del tipo especificado para este XObject.Gets a collection of annotations of the specified type for this XObject.

(Heredado de XObject)
CreateReader()

Crea un objeto XmlReader para este nodo.Creates an XmlReader for this node.

(Heredado de XNode)
CreateReader(ReaderOptions)

Crea una clase XmlReader con las opciones especificadas por el parámetro readerOptions.Creates an XmlReader with the options specified by the readerOptions parameter.

(Heredado de XNode)
CreateWriter()

Crea un objeto XmlWriter que se puede utilizar para agregar los nodos a XContainer.Creates an XmlWriter that can be used to add nodes to the XContainer.

(Heredado de XContainer)
DescendantNodes()

Devuelve una colección de los nodos descendientes de este documento o elemento, clasificados por documento.Returns a collection of the descendant nodes for this document or element, in document order.

(Heredado de XContainer)
Descendants()

Devuelve una colección de los elementos descendientes de este documento o elemento, clasificados por documento.Returns a collection of the descendant elements for this document or element, in document order.

(Heredado de XContainer)
Descendants(XName)

Devuelve una colección filtrada de los elementos descendientes de este documento o elemento, clasificados por documento.Returns a filtered collection of the descendant elements for this document or element, in document order. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

(Heredado de XContainer)
Element(XName)

Obtiene el primer elemento secundario (clasificado por documento) con el XName especificado.Gets the first (in document order) child element with the specified XName.

(Heredado de XContainer)
Elements()

Devuelve una colección de los elementos secundarios de este elemento o documento, clasificados por documento.Returns a collection of the child elements of this element or document, in document order.

(Heredado de XContainer)
Elements(XName)

Devuelve una colección filtrada de elementos secundarios de este documento o elemento, clasificados por documento.Returns a filtered collection of the child elements of this element or document, in document order. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

(Heredado de XContainer)
ElementsAfterSelf()

Devuelve una colección de los elementos relacionados situados detrás de este nodo en el orden del documento.Returns a collection of the sibling elements after this node, in document order.

(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.Returns a filtered collection of the sibling elements after this node, in document order. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

(Heredado de XNode)
ElementsBeforeSelf()

Devuelve una colección de los elementos relacionados situados antes de este nodo en el orden del documento.Returns a collection of the sibling elements before this node, in document order.

(Heredado de XNode)
ElementsBeforeSelf(XName)

Devuelve una colección filtrada de los elementos relacionados situados antes de este nodo en el orden del documento.Returns a filtered collection of the sibling elements before this node, in document order. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

(Heredado de XNode)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IsAfter(XNode)

Determina si el nodo actual aparece después de un nodo especificado respecto al orden del documento.Determines if the current node appears after a specified node in terms of document order.

(Heredado de XNode)
IsBefore(XNode)

Determina si el nodo actual aparece antes de un nodo especificado respecto al orden del documento.Determines if the current node appears before a specified node in terms of document order.

(Heredado de XNode)
Load(Stream)

Crea una nueva instancia de XDocument usando la secuencia especificada.Creates a new XDocument instance by using the specified stream.

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.Creates a new XDocument instance by using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.

Load(String)

Crea un nuevo XDocument a partir de un archivo.Creates a new XDocument from a file.

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.Creates a new XDocument from a file, optionally preserving white space, setting the base URI, and retaining line information.

Load(TextReader)

Crea una nueva clase de XDocument a partir de TextReader.Creates a new XDocument from a 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.Creates a new XDocument from a TextReader, optionally preserving white space, setting the base URI, and retaining line information.

Load(XmlReader)

Crea un nuevo XDocument a partir de un XmlReader.Creates a new XDocument from an 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.Loads an XDocument from an XmlReader, optionally setting the base URI, and retaining line information.

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.Asynchronously creates a new XDocument and initializes its underlying XML tree from the specified stream, optionally preserving white space.

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.Creates a new XDocument and initializes its underlying XML tree using the specified TextReader parameter, optionally preserving white space.

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Crea un nuevo objeto XDocument que incluye el contenido del objeto XmlReader especificado.Creates a new XDocument containing the contents of the specified XmlReader.

MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
Nodes()

Devuelve una colección de los nodos secundarios de este elemento o documento, clasificados por documento.Returns a collection of the child nodes of this element or document, in document order.

(Heredado de XContainer)
NodesAfterSelf()

Devuelve una colección de los nodos relacionados situados detrás de este nodo en el orden del documento.Returns a collection of the sibling nodes after this node, in document order.

(Heredado de XNode)
NodesBeforeSelf()

Devuelve una colección de los nodos relacionados situados antes de este nodo en el orden del documento.Returns a collection of the sibling nodes before this node, in document order.

(Heredado de XNode)
Parse(String)

Crea un nuevo XDocument a partir de una cadena.Creates a new XDocument from a string.

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.Creates a new XDocument from a string, optionally preserving white space, setting the base URI, and retaining line information.

Remove()

Quita este nodo de su elemento primario.Removes this node from its parent.

(Heredado de XNode)
RemoveAnnotations(Type)

Quita las anotaciones del tipo especificado de XObject.Removes the annotations of the specified type from this XObject.

(Heredado de XObject)
RemoveAnnotations<T>()

Quita las anotaciones del tipo especificado de XObject.Removes the annotations of the specified type from this XObject.

(Heredado de XObject)
RemoveNodes()

Quita los nodos secundarios de este documento o elemento.Removes the child nodes from this document or element.

(Heredado de XContainer)
ReplaceNodes(Object)

Reemplaza los nodos secundarios de este documento o elemento por el contenido especificado.Replaces the children nodes of this document or element with the specified content.

(Heredado de XContainer)
ReplaceNodes(Object[])

Reemplaza los nodos secundarios de este documento o elemento por el contenido especificado.Replaces the children nodes of this document or element with the specified content.

(Heredado de XContainer)
ReplaceWith(Object)

Reemplaza este nodo por el contenido especificado.Replaces this node with the specified content.

(Heredado de XNode)
ReplaceWith(Object[])

Reemplaza este nodo por el contenido especificado.Replaces this node with the specified content.

(Heredado de XNode)
Save(Stream)

Genera este XDocument en el objeto Stream especificado.Outputs this XDocument to the specified Stream.

Save(Stream, SaveOptions)

Genera este XDocument en el objeto Stream especificado, especificando opcionalmente el comportamiento de formato.Outputs this XDocument to the specified Stream, optionally specifying formatting behavior.

Save(String)

Serializa este XDocument en un archivo, sobrescribiendo un archivo existente, si existe.Serialize this XDocument to a file, overwriting an existing file, if it exists.

Save(String, SaveOptions)

Serializa XDocument en un archivo, opcionalmente se deshabilita el formato.Serialize this XDocument to a file, optionally disabling formatting.

Save(TextWriter)

Serializa el XDocument en un TextWriter.Serialize this XDocument to a TextWriter.

Save(TextWriter, SaveOptions)

Serializa el XDocument en un TextWriter, opcionalmente se deshabilita el formato.Serialize this XDocument to a TextWriter, optionally disabling formatting.

Save(XmlWriter)

Serializa el XDocument en un XmlWriter.Serialize this XDocument to an XmlWriter.

SaveAsync(Stream, SaveOptions, CancellationToken)

Genera esta clase XDocument en un escritor Stream.Output this XDocument to a Stream.

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Escribe esta clase XDocument en un escritor TextWriter.Writes this XDocument to a TextWriter.

SaveAsync(XmlWriter, CancellationToken)

Escribe esta clase XDocument en un escritor XmlWriter.Writes this XDocument to an XmlWriter.

ToString()

Devuelve el XML con sangría para este nodo.Returns the indented XML for this node.

(Heredado de XNode)
ToString(SaveOptions)

Devuelve el XML de este nodo y, opcionalmente, deshabilita el formato.Returns the XML for this node, optionally disabling formatting.

(Heredado de XNode)
WriteTo(XmlWriter)

Escribe el documento en un objeto XmlWriter.Write this document to an XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

Escribe el árbol XML subyacente de esta clase XDocument en el objeto XmlWriterespecificado.Writes this XDocument's underlying XML tree to the specified XmlWriter.

Eventos

Changed

Se genera cuando este XObject o cualquiera de sus descendientes ha cambiado.Raised when this XObject or any of its descendants have changed.

(Heredado de XObject)
Changing

Se genera cuando este XObject o cualquiera de sus descendientes está a punto de cambiar.Raised when this XObject or any of its descendants are about to change.

(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.Gets a value indicating whether or not this XObject has line information.

(Heredado de XObject)
IXmlLineInfo.LineNumber

Obtiene el número de línea del que el XmlReader subyacente informó para este XObject.Gets the line number that the underlying XmlReader reported for this XObject.

(Heredado de XObject)
IXmlLineInfo.LinePosition

Obtiene la posición de línea de la que el XmlReader subyacente informó para este XObject.Gets the line position that the underlying XmlReader reported for this 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.This method validates that an XDocument conforms to an XSD in an 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).Validates that an XDocument conforms to an XSD in an XmlSchemaSet, optionally populating the XML tree with the post-schema-validation infoset (PSVI).

CreateNavigator(XNode)

Crea un objeto XPathNavigator para XNode.Creates an XPathNavigator for an XNode.

CreateNavigator(XNode, XmlNameTable)

Crea un objeto XPathNavigator para XNode.Creates an XPathNavigator for an XNode. XmlNameTable permite un procesamiento más eficaz de la expresión XPath.The XmlNameTable enables more efficient XPath expression processing.

XPathEvaluate(XNode, String)

Evalúa una expresión XPath.Evaluates an XPath expression.

XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Evalúa una expresión XPath, resolviendo los prefijos de espacio de nombres mediante el IXmlNamespaceResolver especificado.Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElement(XNode, String)

Selecciona un objeto XElement mediante una expresión XPath.Selects an XElement using a XPath expression.

XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Selecciona un XElement utilizando una expresión XPath, que resuelve los prefijos de espacio de nombres mediante el IXmlNamespaceResolver especificado.Selects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElements(XNode, String)

Selecciona una colección de elementos mediante una expresión XPath.Selects a collection of elements using an XPath expression.

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.Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

ToXPathNavigable(XNode)

Devuelve un descriptor de acceso que permite navegar y editar el elemento XNode especificado.Returns an accessor that allows you to navigate and edit the specified XNode.

Se aplica a

Consulte también: