XDocument Constructores

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

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la clase XDocument.

Sobrecargas

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(XDocument)	Inicializa una nueva instancia de la XDocument clase a partir de un objeto existente XDocument .
XDocument(XDeclaration, Object[])	Inicializa una nueva instancia de la XDocument clase con el contenido y especificados XDeclaration .

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 con algún contenido inicial especificado y para crear un XDocument objeto como una copia de otro XDocument objeto.

No hay muchos escenarios que requieren que cree un XDocument. En su lugar, normalmente puede crear su árbol XML con un nodo raíz de XElement. A menos que tenga un requisito específico para crear un documento (por ejemplo, porque tiene que crear instrucciones de procesamiento y comentarios en el nivel superior, o tiene que admitir tipos de documento), a menudo es más cómodo 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 XElement y objetos XDocument.

XDocument()

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

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

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

Consulte también

Se aplica a

XDocument(Object[])

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Inicializa una nueva instancia de la XDocument clase 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

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

Consulte también

Se aplica a

XDocument(XDocument)

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

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

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

Objeto XDocument que se va a copiar.

Comentarios

Use este constructor para realizar una copia profunda 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[])

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

Source:: XDocument.cs

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

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

para XDeclaration el documento.

content: Object[]

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

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

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?