XDocument.Save Methode

Definitie

Naamruimte:: System.Xml.Linq

Assembly's:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Assembly's:: netstandard.dll, System.Xml.XDocument.dll

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Serialiseert dit XDocument naar een bestand, een TextWriterof een XmlWriter.

Overloads

Name	Description
Save(XmlWriter)	Serialiseer dit XDocument in een XmlWriter.
Save(Stream)	Hiermee wordt dit XDocument uitgevoerd naar de opgegeven Stream.
Save(TextWriter)	Serialiseer dit XDocument in een TextWriter.
Save(String)	Serialiseer dit XDocument in een bestand, overschrijf een bestaand bestand als het bestaat.
Save(Stream, SaveOptions)	Hiermee wordt dit XDocument uitgevoerd naar het opgegeven Stream, eventueel opmaakgedrag opgeven.
Save(TextWriter, SaveOptions)	Serialiseer dit XDocument in een TextWriter, eventueel uitgeschakelde opmaak.
Save(String, SaveOptions)	Serialiseer dit XDocument naar een bestand, optioneel het uitschakelen van opmaak.

Save(XmlWriter)

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Serialiseer dit XDocument in een 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)

Parameters

writer: XmlWriter

Een XmlWriter waarnaar de XDocument zal worden geschreven.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een XDocument bestand opslaat in een 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())

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

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

Zie ook

Van toepassing op

Save(Stream)

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Hiermee wordt dit XDocument uitgevoerd naar de opgegeven 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)

Parameters

stream: Stream

De stroom om dit XDocument uit te voeren.

Opmerkingen

De geserialiseerde XML wordt ingesprongen. Alle onbelangrijke witruimte wordt verwijderd en er wordt extra witruimte toegevoegd, zodat de XML correct wordt ingesprongen. Het gedrag van deze methode is dat onbelangrijke witruimte niet behouden blijft.

Als u witruimte wilt beheren, gebruikt u de overbelasting van Save die SaveOptions ruimte als parameter. Gebruik de DisableFormatting optie om niet-ingedeed XML op te slaan. Dit zorgt ervoor dat de schrijver alle witruimten precies zo schrijft als in de XML-structuur.

Gebruik OmitDuplicateNamespaces de optie als u dubbele naamruimtedeclaraties wilt verwijderen.

Van toepassing op

Save(TextWriter)

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Serialiseer dit XDocument in een 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)

Parameters

textWriter: TextWriter

Een TextWriter waarnaar de XDocument zal worden geschreven.

Voorbeelden

In het volgende voorbeeld wordt een XDocument, wordt het document opgeslagen in een StringWriteren wordt de tekenreeks vervolgens naar de console afgedrukt.

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())

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

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

Opmerkingen

Als u witruimte wilt beheren, gebruikt u de overbelasting van Save die SaveOptions ruimte als parameter. Zie Witruimte behouden tijdens het laden of parseren van XML en Witruimte behouden tijdens het serialiseren van witruimte voor meer informatie.

Zie ook

Van toepassing op

Save(String)

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Serialiseer dit XDocument in een bestand, overschrijf een bestaand bestand als het bestaat.

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

public void Save(string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

Parameters

fileName: String

Een tekenreeks die de naam van het bestand bevat.

Voorbeelden

In het volgende voorbeeld wordt een XDocument, wordt het document opgeslagen in een bestand en wordt het bestand vervolgens naar de console afgedrukt.

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"))

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

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

Opmerkingen

Zie ook

Van toepassing op

Save(Stream, SaveOptions)

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Hiermee wordt dit XDocument uitgevoerd naar het opgegeven Stream, eventueel opmaakgedrag opgeven.

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)

Parameters

stream: Stream

De stroom om dit XDocument uit te voeren.

options: SaveOptions

Een SaveOptions die het opmaakgedrag aangeeft.

Opmerkingen

Standaard zijn de instellingen options ingesteld op None. Met deze optie verwijdert u alle overbodige onbelangrijke witruimte en voegt u de juiste onbelangrijke witruimte toe, zodat de XML correct is ingesprongen.

Als u niet-opgemaakte XML wilt opslaan, geeft u de DisableFormatting vlag op voor options. Dit zorgt ervoor dat de schrijver alle witruimten precies zo schrijft als in de XML-structuur.

Gebruik OmitDuplicateNamespaces de optie als u dubbele naamruimtedeclaraties wilt verwijderen.

Van toepassing op

Save(TextWriter, SaveOptions)

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Serialiseer dit XDocument in een TextWriter, eventueel uitgeschakelde opmaak.

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)

Parameters

textWriter: TextWriter

De TextWriter uitvoer van de XML naar.

options: SaveOptions

Een SaveOptions die het opmaakgedrag aangeeft.

Voorbeelden

In het volgende voorbeeld ziet u twee toepassingen van deze methode. Het eerste gebruik serialiseert de XDocument opmaak. De tweede behoudt witruimte. Omdat het document geen witruimte bevat zoals deze is samengesteld, wordt met behoud van witruimte de XML uitgevoerd zonder inspringing.

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

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

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

Opmerkingen

Als u niet-opgemaakte XML wilt opslaan, geeft u de DisableFormatting vlag op voor options. Hierdoor schrijft de schrijver alle witruimte precies zoals weergegeven in de XML-structuur.

Als u ingesprongen XML wilt opslaan, geeft u de DisableFormatting vlag niet op voor options. Hiermee verwijdert u alle overbodige onbelangrijke witruimte en voegt u de juiste onbelangrijke witruimte toe, zodat de XML correct is ingesprongen. Dit is het standaardgedrag en het gedrag van de overbelastingen van de Save methoden die niet als parameter worden gebruikt options .

Zie Witruimte behouden tijdens het laden of parseren van XML en Witruimte behouden tijdens het serialiseren van witruimte voor meer informatie.

Zie ook

Van toepassing op

Save(String, SaveOptions)

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Bron:: XDocument.cs

Serialiseer dit XDocument naar een bestand, optioneel het uitschakelen van opmaak.

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)

Parameters

fileName: String

Een tekenreeks die de naam van het bestand bevat.

options: SaveOptions

Een SaveOptions die het opmaakgedrag aangeeft.

Voorbeelden

In het volgende voorbeeld ziet u twee toepassingen van deze methode. Bij het eerste gebruik blijft witruimte behouden. De tweede serialiseert de XDocument met inspringing.

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"))

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

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

Opmerkingen

Als u niet-opgemaakte XML wilt opslaan, geeft u de DisableFormatting vlag op voor options. Hierdoor schrijft de schrijver alle witruimte precies zoals weergegeven in de XML-structuur.

Zie Witruimte behouden tijdens het laden of parseren van XML en Witruimte behouden tijdens het serialiseren van witruimte voor meer informatie.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?