XDocument Constructores

  • Referencia

Definición

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

Inicializa una nueva instancia de la clase XDocument.

Sobrecargas

XDocument()

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

Inicializa una nueva instancia de la clase XDocument con el contenido especificado.
XDocument(XDocument)

Inicializa una nueva instancia de la clase XDocument a partir de un objeto XDocument ya existente.
XDocument(XDeclaration, Object[])

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

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

Los constructores sobrecargados permiten crear un nuevo vacío XDocument; para crear un XDocument objeto con algún contenido inicial especificado y para crear un XDocument objeto como una copia de otro XDocument objeto.

No existen muchos escenarios que requieran la creación de un objeto XDocument. En su lugar, normalmente puede crear los árboles XML con un nodo raíz XElement. A menos que exista un requisito específico de crear un documento (por ejemplo, porque deba crear instrucciones y comentarios de procesamiento en el nivel superior, o bien deba admitir tipos de documento), a menudo resulta más conveniente usar XElement como nodo raíz.

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

XDocument()

Inicializa una nueva instancia de la clase XDocument.

public:
 XDocument();
public XDocument ();
Public Sub New ()

Ejemplos

En el ejemplo siguiente se crea un nuevo documento y, a continuación, se agrega un comentario y un elemento a él.

XDocument doc = new XDocument();  
doc.Add(new XComment("This is a comment"));  
doc.Add(new XElement("Root", "content"));  
Console.WriteLine(doc);  

Dim doc As XDocument = New XDocument()  
doc.Add(<!--This is a comment-->)  
doc.Add(<Root>content</Root>)  
Console.WriteLine(doc)

Este ejemplo produce el siguiente resultado:

<!--This is a comment-->  
<Root>content</Root>

Comentarios

No existen muchos escenarios que requieran la creación de un objeto XDocument. En su lugar, normalmente puede crear los árboles XML con un nodo raíz XElement. A menos que exista un requisito específico de crear un documento (por ejemplo, porque deba crear instrucciones y comentarios de procesamiento en el nivel superior, o bien deba admitir tipos de documento), a menudo resulta más conveniente usar XElement como nodo raíz.

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

Consulte también

Se aplica a

XDocument(Object[])

Inicializa una nueva instancia de la clase XDocument con el contenido especificado.

public:
 XDocument(... cli::array <System::Object ^> ^ content);
public XDocument (params object[] content);
public XDocument (params object?[] content);
new System.Xml.Linq.XDocument : obj[] -> System.Xml.Linq.XDocument
Public Sub New (ParamArray content As Object())

Parámetros

content
Object[]

Lista de parámetros de objetos de contenido que se van a agregar a este documento.

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

No existen muchos escenarios que requieran la creación de un objeto XDocument. En su lugar, normalmente puede crear los árboles XML con un nodo raíz XElement. A menos que exista un requisito específico de crear un documento (por ejemplo, porque deba crear instrucciones y comentarios de procesamiento en el nivel superior, o bien deba admitir tipos de documento), a menudo resulta más conveniente usar XElement como nodo raíz.

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

Consulte también

Se aplica a

XDocument(XDocument)

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

public:
 XDocument(System::Xml::Linq::XDocument ^ other);
public XDocument (System.Xml.Linq.XDocument other);
new System.Xml.Linq.XDocument : System.Xml.Linq.XDocument -> System.Xml.Linq.XDocument
Public Sub New (other As XDocument)

Parámetros

other
XDocument

El objeto XDocument que se copiará.

Comentarios

Este constructor se usa para realizar una copia en profundidad de .XDocument

Este constructor recorre todos los nodos y atributos del documento especificado en el other parámetro y crea copias de todos los nodos a medida que ensambla el objeto recién inicializado XDocument.

Consulte también

Se aplica a

XDocument(XDeclaration, Object[])

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

public:
 XDocument(System::Xml::Linq::XDeclaration ^ declaration, ... cli::array <System::Object ^> ^ content);
public XDocument (System.Xml.Linq.XDeclaration declaration, params object[] content);
public XDocument (System.Xml.Linq.XDeclaration? declaration, params object[] content);
public XDocument (System.Xml.Linq.XDeclaration? declaration, params object?[] content);
new System.Xml.Linq.XDocument : System.Xml.Linq.XDeclaration * obj[] -> System.Xml.Linq.XDocument
Public Sub New (declaration As XDeclaration, ParamArray content As Object())

Parámetros

declaration
XDeclaration

XDeclaration del documento.

content
Object[]

El contenido del documento.

Ejemplos

En el ejemplo siguiente se usa este constructor para crear un documento.

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 XDeclaration("1.0", "utf-8", "yes"),  
    new XComment("This is a new comment"),  
    new XElement("Root",  
        from el in srcTree.Element("Root").Elements()  
        where ((string)el).StartsWith("data")  
        select el  
    )  
);  
doc.Save("Test.xml");  
Console.WriteLine(File.ReadAllText("Test.xml"));  

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 new comment-->  
        <Root>  
            <%= From el In srcTree.<Root>.Elements _  
                Where CStr(el).StartsWith("data") _  
                Select el %>  
        </Root>  
doc.Save("Test.xml")  
Console.WriteLine(File.ReadAllText("Test.xml"))

Este ejemplo produce el siguiente resultado:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<!--This is a new comment-->  
<Root>  
  <Child1>data1</Child1>  
  <Child2>data2</Child2>  
  <Child3>data3</Child3>  
  <Child2>data4</Child2>  
</Root>

Comentarios

No existen muchos escenarios que requieran la creación de un objeto XDocument. En su lugar, normalmente puede crear los árboles XML con un nodo raíz XElement. A menos que exista un requisito específico de crear un documento (por ejemplo, porque deba crear instrucciones y comentarios de procesamiento en el nivel superior, o bien deba admitir tipos de documento), a menudo resulta más conveniente usar XElement como nodo raíz.

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

Consulte también

Se aplica a