XDocument.Save Metode

Definisi

Ruang nama:

System.Xml.Linq

Rakitan:

netstandard.dll, System.Xml.XDocument.dll

Menserialisasikan ini XDocument ke file, TextWriter, atau XmlWriter.

Overload

Nama	Deskripsi
Save(XmlWriter)	Menserialisasikan ini XDocument ke XmlWriter.
Save(Stream)	Output ini XDocument ke yang ditentukan Stream.
Save(TextWriter)	Menserialisasikan ini XDocument ke TextWriter.
Save(String)	Menserialisasikan ini XDocument ke file, menimpa file yang ada, jika ada.
Save(Stream, SaveOptions)	Menghasilkan ini XDocument ke perilaku pemformatan yang ditentukan Stream, secara opsional.
Save(TextWriter, SaveOptions)	Menserialisasikan ini XDocument ke TextWriter, secara opsional menonaktifkan pemformatan.
Save(String, SaveOptions)	Serialkan ini XDocument ke file, secara opsional menonaktifkan pemformatan.

Save(XmlWriter)

Sumber:

XDocument.cs

Menserialisasikan ini XDocument 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

(yaitu XmlWriter ) orang-orang XDocument yang akan ditulis.

Contoh

Contoh berikut menunjukkan cara menyimpan XDocument ke XmlWriter.

StringBuilder sb = new StringBuilder();
XmlWriterSettings xws = new XmlWriterSettings();
xws.OmitXmlDeclaration = true;
xws.Indent = true;

using (XmlWriter xw = XmlWriter.Create(sb, xws)) {
    XDocument doc = new XDocument(
        new XElement("Child",
            new XElement("GrandChild", "some content")
        )
    );
    doc.Save(xw);
}

Console.WriteLine(sb.ToString());

Dim sb As StringBuilder = New StringBuilder()
Dim xws As XmlWriterSettings = New XmlWriterSettings()
xws.OmitXmlDeclaration = True
xws.Indent = True

Using xw = XmlWriter.Create(sb, xws)
    Dim doc As XDocument = New XDocument(<Child><GrandChild>some content</GrandChild></Child>)
    doc.Save(xw)

End Using

Console.WriteLine(sb.ToString())

Contoh ini menghasilkan output berikut:

<Child>
  <GrandChild>some content</GrandChild>
</Child>

Lihat juga

• WriteTo(XmlWriter)
• Load
• Parse
• Gambaran umum LINQ ke XML
• Cara membaca dan menulis dokumen yang dikodekan

Save(Stream)

Sumber:

XDocument.cs

Output ini XDocument ke yang ditentukan Stream.

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 ini XDocument .

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 diperlukan SaveOptions sebagai parameter. DisableFormatting Gunakan opsi untuk menyimpan XML yang tidak terindentasi. Ini akan menyebabkan penulis menulis semua spasi putih persis seperti yang diwakili di pohon XML.

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

Save(TextWriter)

Sumber:

XDocument.cs

Menserialisasikan ini XDocument 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

(yaitu TextWriter ) orang-orang XDocument yang akan ditulis.

Contoh

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

StringBuilder sb = new StringBuilder();

XDocument doc = new XDocument(
    new XElement("Root",
        new XElement("Child", "content")
    )
);
TextWriter tr = new StringWriter(sb);
doc.Save(tr);
Console.WriteLine(sb.ToString());

Dim sb As StringBuilder = New StringBuilder()

Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8"?>
        <Root><Child>content</Child></Root>

Dim tr As TextWriter = New StringWriter(sb)
doc.Save(tr)
Console.WriteLine(sb.ToString())

Contoh ini menghasilkan output berikut:

<?xml version="1.0" encoding="utf-16"?>
<Root>
  <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 ruang putih yang tidak signifikan tidak akan dipertahankan.

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

Lihat juga

• WriteTo(XmlWriter)
• Load
• Parse
• Gambaran umum LINQ ke XML
• Cara membaca dan menulis dokumen yang dikodekan

Save(String)

Sumber:

XDocument.cs

Menserialisasikan ini XDocument ke file, menimpa file yang ada, jika ada.

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 XDocument, menyimpan dokumen ke file, lalu mencetak file ke konsol.

XDocument doc = new XDocument(
    new XElement("Root",
        new XElement("Child", "content")
    )
);
doc.Save("Root.xml");
Console.WriteLine(File.ReadAllText("Root.xml"));

Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8"?>
        <Root><Child>content</Child></Root>

doc.Save("Root.xml")
Console.WriteLine(File.ReadAllText("Root.xml"))

Contoh ini menghasilkan output berikut:

<?xml version="1.0" encoding="utf-8"?>
<Root>
  <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 ruang putih yang tidak signifikan tidak akan dipertahankan.

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

Lihat juga

• WriteTo(XmlWriter)
• Load
• Parse
• Gambaran umum LINQ ke XML
• Cara membaca dan menulis dokumen yang dikodekan

Save(Stream, SaveOptions)

Sumber:

XDocument.cs

Menghasilkan ini XDocument ke perilaku pemformatan yang ditentukan Stream, secara opsional.

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 ini XDocument .

options

SaveOptions

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 DisableFormatting bendera untuk options. Ini akan menyebabkan penulis menulis semua spasi putih persis seperti yang diwakili di pohon XML.

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

Save(TextWriter, SaveOptions)

Sumber:

XDocument.cs

Menserialisasikan ini XDocument 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 menserialisasikan XDocument dengan pemformatan. Yang kedua mempertahankan spasi kosong. Karena dokumen tidak memiliki spasi kosong di dalamnya seperti yang dibangun, mempertahankan spasi putih menghasilkan XML tanpa inden apa pun.

XDocument doc = new XDocument(
    new XElement("Root",
        new XElement("Child", "content")
    )
);
StringBuilder sb1 = new StringBuilder();
using (StringWriter sr1 = new StringWriter(sb1)) {
    doc.Save(sr1, SaveOptions.None);
    Console.WriteLine(sb1.ToString());
}

StringBuilder sb2 = new StringBuilder();
using (StringWriter sr2 = new StringWriter(sb2)) {
    doc.Save(sr2, SaveOptions.DisableFormatting);
    Console.WriteLine(sb2.ToString());
}

Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8"?>
        <Root><Child>content</Child></Root>

Dim sb1 As StringBuilder = New StringBuilder()

Using sr1 = New StringWriter(sb1)
    doc.Save(sr1, SaveOptions.None)
    Console.WriteLine(sb1.ToString())
End Using

Dim sb2 As StringBuilder = New StringBuilder()

Using sr2 = New StringWriter(sb2)
    doc.Save(sr2, SaveOptions.DisableFormatting)
    Console.WriteLine(sb2.ToString())
End Using

Contoh ini menghasilkan output berikut:

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

Keterangan

Jika Anda ingin menyimpan XML yang tidak terindentasi, tentukan DisableFormatting bendera 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 DisableFormatting bendera 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 Save metode yang tidak mengambil options sebagai parameter.

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

Lihat juga

• WriteTo(XmlWriter)
• Load
• Parse
• Gambaran umum LINQ ke XML
• Cara membaca dan menulis dokumen yang dikodekan

Save(String, SaveOptions)

Sumber:

XDocument.cs

Serialkan ini XDocument 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 XDocument dengan inden.

XDocument doc = new XDocument(
    new XElement("Root",
        new XElement("Child", "content")
    )
);
doc.Save("Root1.xml", SaveOptions.DisableFormatting);
Console.WriteLine(File.ReadAllText("Root1.xml"));
doc.Save("Root2.xml", SaveOptions.None);
Console.WriteLine(File.ReadAllText("Root2.xml"));

Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8"?>
        <Root><Child>content</Child></Root>

doc.Save("Root1.xml", SaveOptions.DisableFormatting)
Console.WriteLine(File.ReadAllText("Root1.xml"))
doc.Save("Root2.xml", SaveOptions.None)
Console.WriteLine(File.ReadAllText("Root2.xml"))

Contoh ini menghasilkan output berikut:

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

Keterangan

Jika Anda ingin menyimpan XML yang tidak terindentasi, tentukan DisableFormatting bendera 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 DisableFormatting bendera 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 Save metode yang tidak mengambil options sebagai parameter.

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

Lihat juga

• WriteTo(XmlWriter)
• Load
• Parse
• Gambaran umum LINQ ke XML
• Cara: Membaca dan Menulis Dokumen yang Dikodekan