Compartir vía

XElement.Save Método

  • Referencia

Definición

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

Serialice el árbol XML subyacente de este elemento. El resultado se puede guardar en un archivo, XmlTextWriter, TextWriter o XmlWriter. Opcionalmente, se puede deshabilitar el formato (sangría).

Sobrecargas

Save(Stream)

Genera este XElement en el objeto Stream especificado.
Save(TextWriter)

Serialice este elemento en un objeto TextWriter.
Save(String)

Serialice este elemento en un archivo.
Save(XmlWriter)

Serialice este elemento en un objeto XmlWriter.
Save(Stream, SaveOptions)

Genera este XElement en el objeto Stream especificado, especificando opcionalmente el comportamiento de formato.
Save(TextWriter, SaveOptions)

Serialice este elemento en un TextWriter y, de manera opcional, deshabilite el formato.
Save(String, SaveOptions)

Serialice este elemento en un archivo y, de manera opcional, deshabilite el formato.

Save(Stream)

Genera este XElement en el objeto Stream especificado.

public:
 void Save(System::IO::Stream ^ stream);
public void Save (System.IO.Stream stream);
member this.Save : System.IO.Stream -> unit
Public Sub Save (stream As Stream)

Parámetros

stream
Stream

Secuencia que se envía a este XElement.

Comentarios

El XML serializado se aplicará sangría. Se quitarán todos los espacios en blanco insignificantes y se agregará espacio en blanco adicional para que el XML se aplique correctamente la sangría. El comportamiento de este método es que no se conservarán espacios en blanco insignificantes.

Si desea controlar el espacio en blanco, use la sobrecarga de Save que toma SaveOptions como parámetro. Use la DisableFormatting opción para guardar XML sin sangría. Esto hará que el escritor escriba todos los espacios en blanco exactamente como se representan en el árbol XML.

Use la OmitDuplicateNamespaces opción si desea quitar declaraciones de espacio de nombres duplicadas.

Se aplica a

Save(TextWriter)

Serialice este elemento en un objeto TextWriter.

public:
 void Save(System::IO::TextWriter ^ textWriter);
public void Save (System.IO.TextWriter textWriter);
member this.Save : System.IO.TextWriter -> unit
Public Sub Save (textWriter As TextWriter)

Parámetros

textWriter
TextWriter

TextWriter en el que se escribirá un XElement.

Ejemplos

En el ejemplo siguiente se crea un XElementobjeto , se guarda el documento StringWriteren y, a continuación, se imprime la cadena en la consola.

XElement root = XElement.Parse(@"<Root> <Child> Text </Child> </Root>");  
using (StringWriter sw = new StringWriter()) {  
    root.Save(sw);  
    Console.WriteLine(sw.ToString());  
}  

Dim root As XElement = <Root><Child> Text </Child></Root>  
Using sw = New StringWriter()  
    root.Save(sw)  
    Console.WriteLine(sw.ToString())  
End Using

Este ejemplo produce el siguiente resultado:

<?xml version="1.0" encoding="utf-16"?>  
<Root>  
  <Child> Text </Child>  
</Root>

Comentarios

El XML serializado se aplicará sangría. Se quitarán todos los espacios en blanco insignificantes y se agregará espacio en blanco adicional para que el XML se aplique correctamente la sangría. El comportamiento de este método es que no se conservará el espacio en blanco.

Si desea controlar el espacio en blanco, use la sobrecarga de Save que le permite especificar SaveOptions como parámetro. Para obtener más información, vea Conservar el espacio en blanco al cargar o analizar XML y Conservar el espacio en blanco durante la serialización.

Consulte también

Se aplica a

Save(String)

Serialice este elemento en un archivo.

public:
 void Save(System::String ^ fileName);
public void Save (string fileName);
member this.Save : string -> unit
Public Sub Save (fileName As String)

Parámetros

fileName
String

Objeto String que contiene el nombre del archivo.

Ejemplos

En el ejemplo siguiente se crea un XElementobjeto , se guarda el documento en un archivo y, a continuación, se imprime el archivo en la consola.

XElement root = new XElement("Root",  
    new XElement("Child", "child content")  
);  
root.Save("Root.xml");  
string str = File.ReadAllText("Root.xml");  
Console.WriteLine(str);  

Dim root As XElement = _   
        <Root>  
            <Child>child content</Child>  
        </Root>  
root.Save("Root.xml")  
Dim Str As String = File.ReadAllText("Root.xml")  
Console.WriteLine(Str)

Este ejemplo produce el siguiente resultado:

<?xml version="1.0" encoding="utf-8"?>  
<Root>  
  <Child>child content</Child>  
</Root>

Comentarios

El XML serializado se aplicará sangría. Se quitarán todos los espacios en blanco insignificantes y se agregará espacio en blanco adicional para que el XML se aplique correctamente la sangría. El comportamiento de este método es que los nodos de espacio en blanco insignificantes del árbol XML no se conservarán.

Si desea controlar el espacio en blanco, use la sobrecarga de Save que le permite especificar SaveOptions como parámetro. Para obtener más información, vea Conservar el espacio en blanco al cargar o analizar XML y Conservar el espacio en blanco durante la serialización.

Consulte también

Se aplica a

Save(XmlWriter)

Serialice este elemento en un objeto XmlWriter.

public:
 void Save(System::Xml::XmlWriter ^ writer);
public void Save (System.Xml.XmlWriter writer);
member this.Save : System.Xml.XmlWriter -> unit
Public Sub Save (writer As XmlWriter)

Parámetros

writer
XmlWriter

XmlWriter en el que se escribirá un XElement.

Ejemplos

En el siguiente ejemplo se muestra cómo guardar un XElement en un XmlWriter.

StringBuilder sb = new StringBuilder();  
XmlWriterSettings xws = new XmlWriterSettings();  
xws.OmitXmlDeclaration = true;  
using (XmlWriter xw = XmlWriter.Create(sb, xws)) {  
    XElement root = new XElement("Root",  
        new XElement("Child", "child content")  
    );  
    root.Save(xw);  
}  
Console.WriteLine(sb.ToString());  

Dim sb As StringBuilder = New StringBuilder()  
Dim xws As XmlWriterSettings = New XmlWriterSettings()  
xws.OmitXmlDeclaration = True  
Using xw = XmlWriter.Create(sb, xws)  
    Dim root As XElement = <Root>  
                               <Child>child content</Child>  
                           </Root>  
    root.Save(xw)  
End Using  
Console.WriteLine(sb.ToString())

Este ejemplo produce el siguiente resultado:

<Root><Child>child content</Child></Root>

Consulte también

Se aplica a

Save(Stream, SaveOptions)

Genera este XElement en el objeto Stream especificado, especificando opcionalmente el comportamiento de formato.

public:
 void Save(System::IO::Stream ^ stream, System::Xml::Linq::SaveOptions options);
public void Save (System.IO.Stream stream, System.Xml.Linq.SaveOptions options);
member this.Save : System.IO.Stream * System.Xml.Linq.SaveOptions -> unit
Public Sub Save (stream As Stream, options As SaveOptions)

Parámetros

stream
Stream

Secuencia que se envía a este XElement.

options
SaveOptions

Objeto SaveOptions que especifica el comportamiento de formato.

Comentarios

De forma predeterminada, se options establece Noneen . Esta opción quitará todos los espacios en blanco insignificantes extraños y agregará un espacio en blanco insignificante adecuado para que el XML tenga sangría correcta.

Si desea guardar XML sin sangr, especifique la DisableFormatting marca para options. Esto hará que el escritor escriba todos los espacios en blanco exactamente como se representan en el árbol XML.

Use la OmitDuplicateNamespaces opción si desea quitar declaraciones de espacio de nombres duplicadas.

Se aplica a

Save(TextWriter, SaveOptions)

Serialice este elemento en un TextWriter y, de manera opcional, deshabilite el formato.

public:
 void Save(System::IO::TextWriter ^ textWriter, System::Xml::Linq::SaveOptions options);
public void Save (System.IO.TextWriter textWriter, System.Xml.Linq.SaveOptions options);
member this.Save : System.IO.TextWriter * System.Xml.Linq.SaveOptions -> unit
Public Sub Save (textWriter As TextWriter, options As SaveOptions)

Parámetros

textWriter
TextWriter

TextWriter al que se envía el XML.

options
SaveOptions

SaveOptions que especifica el comportamiento de formato.

Ejemplos

En el ejemplo siguiente se muestran dos usos de este método. El primer uso conserva los espacios en blanco. El segundo serializa con XElement formato. Dado que el documento no tiene ningún espacio en blanco en él tal como se construye, conservando los espacios en blanco genera el XML sin sangría.

XElement root = XElement.Parse(@"<Root> <Child> Text </Child> </Root>");  

using (StringWriter sw = new StringWriter())  
{  
    root.Save(sw, SaveOptions.DisableFormatting);  
    Console.WriteLine(sw.ToString());  
}  

Console.WriteLine("=====");  

using (StringWriter sw = new StringWriter())  
{  
    root.Save(sw, SaveOptions.None);  
    Console.WriteLine(sw.ToString());  
}  

Dim root As XElement = <Root><Child> Text </Child></Root>  

Using sw = New StringWriter()  
    root.Save(sw, SaveOptions.DisableFormatting)  
    Console.WriteLine(sw.ToString())  
End Using  

Console.WriteLine("=====")  

Using sw = New StringWriter()  
    root.Save(sw, SaveOptions.None)  
    Console.WriteLine(sw.ToString())  
End Using

Este ejemplo produce el siguiente resultado:

<?xml version="1.0" encoding="utf-16"?><Root><Child> Text </Child></Root>  
=====  
<?xml version="1.0" encoding="utf-16"?>  
<Root>  
  <Child> Text </Child>  
</Root>

Comentarios

Si desea guardar XML sin sangr, especifique la DisableFormatting marca para options. Esto hará que el escritor escriba todos los espacios en blanco exactamente como se representan en el árbol XML.

Si desea guardar xml con sangría, no especifique la DisableFormatting marca para options. Esto eliminará todos los espacios en blanco insignificantes extraños y agregará un espacio en blanco insignificante adecuado para que el XML tenga sangría correcta. Este es el comportamiento predeterminado y el comportamiento de las sobrecargas de los Save métodos que no toman options como parámetro.

Para obtener más información, vea Conservar el espacio en blanco al cargar o analizar XML y Conservar espacio en blanco mientras se serializa.

Consulte también

Se aplica a

Save(String, SaveOptions)

Serialice este elemento en un archivo y, de manera opcional, deshabilite el formato.

public:
 void Save(System::String ^ fileName, System::Xml::Linq::SaveOptions options);
public void Save (string fileName, System.Xml.Linq.SaveOptions options);
member this.Save : string * System.Xml.Linq.SaveOptions -> unit
Public Sub Save (fileName As String, options As SaveOptions)

Parámetros

fileName
String

Objeto String que contiene el nombre del archivo.

options
SaveOptions

SaveOptions que especifica el comportamiento de formato.

Ejemplos

En el ejemplo siguiente se muestran dos usos de este método. El primer uso conserva los espacios en blanco. La segunda serializa con XElement formato.

string str;  
XElement root = XElement.Parse(@"<Root> <Child> Text </Child> </Root>");  

root.Save("Root.xml", SaveOptions.DisableFormatting);  
str = File.ReadAllText("Root.xml");  
Console.WriteLine(str);  

Console.WriteLine("=====");  

root.Save("Root.xml", SaveOptions.None);  
str = File.ReadAllText("Root.xml");  
Console.WriteLine(str);  

Dim str As String  
Dim root As XElement = <Root><Child> Text </Child></Root>  

root.Save("Root.xml", SaveOptions.DisableFormatting)  
str = File.ReadAllText("Root.xml")  
Console.WriteLine(str)  

Console.WriteLine("=====")  

root.Save("Root.xml", SaveOptions.None)  
str = File.ReadAllText("Root.xml")  
Console.WriteLine(str)

Este ejemplo produce el siguiente resultado:

<?xml version="1.0" encoding="utf-8"?><Root><Child> Text </Child></Root>  
=====  
<?xml version="1.0" encoding="utf-8"?>  
<Root>  
  <Child> Text </Child>  
</Root>

Comentarios

Si desea guardar XML sin sangr, especifique la DisableFormatting marca para options. Esto hará que el escritor escriba todos los espacios en blanco exactamente como se representan en el árbol XML.

Si desea guardar xml con sangría, no especifique la DisableFormatting marca para options. Esto eliminará todos los espacios en blanco insignificantes extraños y agregará un espacio en blanco insignificante adecuado para que el XML tenga sangría correcta. Este es el comportamiento predeterminado y el comportamiento de las sobrecargas de los Save métodos que no toman options como parámetro.

Para obtener más información, vea Conservar el espacio en blanco al cargar o analizar XML y Conservar espacio en blanco mientras se serializa.

Consulte también

Se aplica a