XElement.Save Metode

Referensi

Definisi

Ruang nama:: System.Xml.Linq

Rakitan:: System.Xml.XDocument.dll

Rakitan:: System.Xml.Linq.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menserialisasikan pohon XML dasar elemen ini. Output dapat disimpan ke file, XmlTextWriter, TextWriter, atau XmlWriter. Secara opsional, pemformatan (indentasi) dapat dinonaktifkan.

Overload

Save(Stream)	Menghasilkan XElement ini ke Streamyang ditentukan .
Save(TextWriter)	Serialisasi elemen ini ke TextWriter.
Save(String)	Serialisasi elemen ini ke file.
Save(XmlWriter)	Serialisasi elemen ini ke XmlWriter.
Save(Stream, SaveOptions)	Menghasilkan XElement ini ke Streamyang ditentukan, secara opsional menentukan perilaku pemformatan.
Save(TextWriter, SaveOptions)	Serialisasi elemen ini ke TextWriter, secara opsional menonaktifkan pemformatan.
Save(String, SaveOptions)	Serialisasi elemen ini ke file, secara opsional menonaktifkan pemformatan.

Save(Stream)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Menghasilkan XElement ini ke Streamyang ditentukan .

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)

Parameter

stream: Stream

Aliran untuk menghasilkan XElement ini.

Keterangan

XML berseri akan diindentasi. Semua spasi putih yang tidak signifikan akan dihapus, dan spasi kosong tambahan akan ditambahkan sehingga XML akan diindentasi dengan benar. Perilaku metode ini adalah bahwa ruang putih yang tidak signifikan tidak akan dipertahankan.

Jika Anda ingin mengontrol spasi kosong, gunakan kelebihan beban Save yang mengambil SaveOptions sebagai parameter. Gunakan opsi DisableFormatting untuk menyimpan XML yang tidak terindentasi. Ini akan menyebabkan penulis menulis semua spasi putih persis seperti yang diwakili di pohon XML.

Gunakan opsi OmitDuplicateNamespaces jika Anda ingin menghapus deklarasi namespace layanan duplikat.

Berlaku untuk

Save(TextWriter)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Serialisasi elemen ini ke 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)

Parameter

textWriter: TextWriter

TextWriter yang akan ditulis oleh XElement.

Contoh

Contoh berikut membuat XElement, menyimpan dokumen ke StringWriter, lalu mencetak string ke konsol.

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

Contoh ini menghasilkan output berikut:

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

Keterangan

Jika Anda ingin mengontrol spasi kosong, gunakan kelebihan beban Save yang memungkinkan Anda menentukan SaveOptions sebagai parameter. Untuk informasi selengkapnya, lihat Mempertahankan spasi kosong saat memuat atau mengurai XML dan Mempertahankan spasi putih saat membuat serialisasi.

Lihat juga

gambaran umum LINQ ke XML

Berlaku untuk

Save(String)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Serialisasi elemen ini ke file.

public:
 void Save(System::String ^ fileName);

public void Save (string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

Parameter

fileName: String

String yang berisi nama file.

Contoh

Contoh berikut membuat XElement, menyimpan dokumen ke file, lalu mencetak file ke konsol.

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)

Contoh ini menghasilkan output berikut:

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

Keterangan

XML berseri akan diindentasi. Semua spasi putih yang tidak signifikan akan dihapus, dan spasi kosong tambahan akan ditambahkan sehingga XML akan diindentasi dengan benar. Perilaku metode ini adalah bahwa simpul spasi putih yang tidak signifikan di pohon XML tidak akan dipertahankan.

Lihat juga

gambaran umum LINQ ke XML

Berlaku untuk

Save(XmlWriter)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Serialisasi elemen ini ke 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)

Parameter

writer: XmlWriter

XmlWriter yang akan ditulis oleh XElement.

Contoh

Contoh berikut menunjukkan cara menyimpan XElement ke 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())

Contoh ini menghasilkan output berikut:

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

Lihat juga

gambaran umum LINQ ke XML

Berlaku untuk

Save(Stream, SaveOptions)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Menghasilkan XElement ini ke Streamyang ditentukan, secara opsional menentukan perilaku pemformatan.

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)

Parameter

stream: Stream

Aliran untuk menghasilkan XElement ini.

options: SaveOptions

Objek SaveOptions yang menentukan perilaku pemformatan.

Keterangan

Secara default options diatur ke None. Opsi ini akan menghapus semua spasi kosong yang tidak signifikan, dan menambahkan ruang putih yang tidak signifikan yang sesuai sehingga XML diindentasi dengan benar.

Jika Anda ingin menyimpan XML yang tidak terindentasi, tentukan bendera DisableFormatting untuk options. Ini akan menyebabkan penulis menulis semua spasi putih persis seperti yang diwakili di pohon XML.

Gunakan opsi OmitDuplicateNamespaces jika Anda ingin menghapus deklarasi namespace layanan duplikat.

Berlaku untuk

Save(TextWriter, SaveOptions)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Serialisasi elemen ini ke TextWriter, secara opsional menonaktifkan pemformatan.

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)

Parameter

textWriter: TextWriter

TextWriter untuk menghasilkan XML.

options: SaveOptions

SaveOptions yang menentukan perilaku pemformatan.

Contoh

Contoh berikut menunjukkan dua penggunaan metode ini. Penggunaan pertama mempertahankan spasi kosong. Yang kedua menserialisasikan XElement dengan pemformatan. Karena dokumen tidak memiliki spasi kosong di dalamnya seperti yang dibangun, mempertahankan spasi putih menghasilkan XML tanpa inden apa pun.

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

Contoh ini menghasilkan output berikut:

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

Keterangan

Jika Anda ingin menyimpan XML yang tidak terindentasi, tentukan bendera DisableFormatting untuk options. Ini akan menyebabkan penulis menulis semua spasi kosong persis seperti yang diwakili di pohon XML.

Jika Anda ingin menyimpan XML yang terindentasi, jangan tentukan bendera DisableFormatting untuk options. Ini akan menghapus semua spasi putih asing yang tidak signifikan, dan menambahkan ruang putih yang tidak signifikan yang sesuai sehingga XML diindentasikan dengan benar. Ini adalah perilaku default, dan perilaku kelebihan beban metode Save yang tidak mengambil options sebagai parameter.

Untuk informasi selengkapnya, lihat Mempertahankan spasi kosong saat memuat atau mengurai XML dan Mempertahankan spasi putih saat membuat serialisasi.

Lihat juga

gambaran umum LINQ ke XML

Berlaku untuk

Save(String, SaveOptions)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Serialisasi elemen ini ke file, secara opsional menonaktifkan pemformatan.

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)

Parameter

fileName: String

String yang berisi nama file.

options: SaveOptions

SaveOptions yang menentukan perilaku pemformatan.

Contoh

Contoh berikut menunjukkan dua penggunaan metode ini. Penggunaan pertama mempertahankan spasi kosong. Yang kedua menserialisasikan XElement dengan pemformatan.

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)

Contoh ini menghasilkan output berikut:

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

Keterangan

Untuk informasi selengkapnya, lihat Mempertahankan spasi kosong saat memuat atau mengurai XML dan Mempertahankan spasi putih saat membuat serialisasi.

Lihat juga

gambaran umum LINQ ke XML

Berlaku untuk

Bagikan melalui

XElement.Save Metode

Definisi

Overload

Save(Stream)

Parameter

Keterangan

Berlaku untuk

Save(TextWriter)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

Save(String)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

Save(XmlWriter)

Parameter

Contoh

Lihat juga

Berlaku untuk

Save(Stream, SaveOptions)

Parameter

Keterangan

Berlaku untuk

Save(TextWriter, SaveOptions)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

Save(String, SaveOptions)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: