XElement.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.

Serialiseer de onderliggende XML-structuur van dit element. De uitvoer kan worden opgeslagen in een bestand, een XmlTextWriter, een TextWriterof een XmlWriter. Optioneel kan opmaak (inspringen) worden uitgeschakeld.

Overloads

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

Save(Stream)

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Hiermee wordt dit XElement 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 XElement 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 de OmitDuplicateNamespaces optie als u dubbele naamruimtedeclaraties wilt verwijderen.

Van toepassing op

Save(TextWriter)

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Serialiseer dit element 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 XElement zal worden geschreven.

Voorbeelden

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

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

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

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

Opmerkingen

Als u witruimte wilt beheren, gebruikt u de overbelasting die Save u kunt opgeven SaveOptions 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

Overzicht van LINQ naar XML

Van toepassing op

Save(String)

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Serialiseer dit element naar een bestand.

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 String met de naam van het bestand.

Voorbeelden

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

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)

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

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

Opmerkingen

Zie ook

Overzicht van LINQ naar XML

Van toepassing op

Save(XmlWriter)

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Serialiseer dit element 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 XElement zal worden geschreven.

Voorbeelden

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

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

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

Zie ook

Overzicht van LINQ naar XML

Van toepassing op

Save(Stream, SaveOptions)

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Hiermee wordt dit XElement 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 XElement uit te voeren.

options: SaveOptions

Een SaveOptions object dat 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:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Serialiseer dit element naar 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. Bij het eerste gebruik blijft witruimte behouden. De tweede serialiseert de XElement met opmaak. Omdat het document geen witruimte bevat zoals deze is samengesteld, wordt met behoud van witruimte de XML uitgevoerd zonder inspringing.

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

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

<?xml version="1.0" encoding="utf-16"?><Root><Child> Text </Child></Root>
=====
<?xml version="1.0" encoding="utf-16"?>
<Root>
  <Child> Text </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

Overzicht van LINQ naar XML

Van toepassing op

Save(String, SaveOptions)

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Bron:: XElement.cs

Serialiseer dit element 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 String met de naam van het bestand.

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 XElement met opmaak.

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)

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

<?xml version="1.0" encoding="utf-8"?><Root><Child> Text </Child></Root>
=====
<?xml version="1.0" encoding="utf-8"?>
<Root>
  <Child> Text </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

Overzicht van LINQ naar XML

Van toepassing op

Feedback

Is deze pagina nuttig?