XStreamingElement.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 dit streaming-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 XStreamingElement uitgevoerd naar de opgegeven Stream.
Save(TextWriter)	Serialiseer dit streaming-element naar een TextWriter.
Save(String)	Serialiseer dit streaming-element naar een bestand.
Save(XmlWriter)	Serialiseer dit streaming-element naar een XmlWriter.
Save(Stream, SaveOptions)	Hiermee wordt dit XStreamingElement uitgevoerd naar het opgegeven Stream, eventueel opmaakgedrag opgeven.
Save(TextWriter, SaveOptions)	Serialiseer dit streaming-element naar een TextWriter, optioneel uitschakelen van opmaak.
Save(String, SaveOptions)	Serialiseer dit streaming-element naar een bestand, optioneel het uitschakelen van opmaak.

Save(Stream)

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Hiermee wordt dit XStreamingElement 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:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Serialiseer dit streaming-element naar 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 XStreamingElement zal worden geschreven.

Voorbeelden

In het volgende voorbeeld wordt een xml-bronstructuur gemaakt en wordt vervolgens een XStreamingElement instantie gemaakt met behulp van een query in de xml-bronstructuur. Vervolgens wordt het streaming-element naar een StringWriter.

XElement srcTree = new XElement("Root",
                       new XElement("Child", 1),
                       new XElement("Child", 2),
                       new XElement("Child", 3),
                       new XElement("Child", 4),
                       new XElement("Child", 5)
                   );

XStreamingElement dstTree = new XStreamingElement("NewRoot",
                        from el in srcTree.Elements()
                        where (int)el >= 3
                        select new XElement("DifferentChild", (int)el)
                    );

StringBuilder sb = new StringBuilder();
dstTree.Save(new StringWriter(sb));
Console.WriteLine(sb.ToString());

Dim srcTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot", _
                        From el In srcTree.Elements() _
                        Where el.Value >= 3 _
                        Select <DifferentChild><%= el.Value %></DifferentChild> _
                    )

Dim sb As StringBuilder = New StringBuilder()
dstTree.Save(New StringWriter(sb))
Console.WriteLine(sb.ToString())

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

<?xml version="1.0" encoding="utf-16"?>
<NewRoot>
  <DifferentChild>3</DifferentChild>
  <DifferentChild>4</DifferentChild>
  <DifferentChild>5</DifferentChild>
</NewRoot>

Opmerkingen

Als u witruimte wilt beheren, gebruikt u een van de overbelastingen ervan Save 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:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Serialiseer dit streaming-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 streaming-XML-structuur gemaakt. Vervolgens wordt de streaming-XML-structuur naar een bestand geserialiseerd.

XElement srcTree = new XElement("Root",
                       new XElement("Child", 1),
                       new XElement("Child", 2),
                       new XElement("Child", 3),
                       new XElement("Child", 4),
                       new XElement("Child", 5)
                   );

XStreamingElement dstTree = new XStreamingElement("NewRoot",
                        from el in srcTree.Elements()
                        where (int)el >= 3
                        select new XElement("DifferentChild", (int)el)
                    );

dstTree.Save("Test.xml");
Console.WriteLine(File.ReadAllText("Test.xml"));

Dim srcTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot", _
                        From el In srcTree.Elements() _
                        Where el.Value >= 3 _
                        Select <DifferentChild><%= el.Value %></DifferentChild> _
                    )

dstTree.Save("Test.xml")
Console.WriteLine(File.ReadAllText("Test.xml"))

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

<?xml version="1.0" encoding="utf-8"?>
<NewRoot>
  <DifferentChild>3</DifferentChild>
  <DifferentChild>4</DifferentChild>
  <DifferentChild>5</DifferentChild>
</NewRoot>

Opmerkingen

Zie ook

Overzicht van LINQ naar XML

Van toepassing op

Save(XmlWriter)

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Serialiseer dit streaming-element naar 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 wordt een XStreamingElement bestand gemaakt en naar een XmlWritergeschreven.

XElement srcTree = new XElement("Root",
                       new XElement("Child", 1),
                       new XElement("Child", 2),
                       new XElement("Child", 3),
                       new XElement("Child", 4),
                       new XElement("Child", 5)
                   );

StringBuilder sb = new StringBuilder();
XmlWriterSettings xws = new XmlWriterSettings();
xws.OmitXmlDeclaration = true;
using (XmlWriter xw = XmlWriter.Create(sb, xws))
{
    XStreamingElement dstTree = new XStreamingElement("NewRoot",
                            from el in srcTree.Elements()
                            where (int)el == 5
                            select new XElement("DifferentChild", (int)el)
                        );

    dstTree.Save(xw);
}
Console.WriteLine(sb.ToString());

Dim srcTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>

Dim sb As StringBuilder = New StringBuilder()
Dim xws As XmlWriterSettings = New XmlWriterSettings()
xws.OmitXmlDeclaration = True
Using xw As XmlWriter = XmlWriter.Create(sb, xws)
    Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot", _
                            From el In srcTree.Elements() _
                            Where el.Value = 5 _
                            Select <DifferentChild><%= el.Value %></DifferentChild> _
                        )
    dstTree.Save(xw)
End Using
Console.WriteLine(sb.ToString())

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

<NewRoot><DifferentChild>5</DifferentChild></NewRoot>

Zie ook

Overzicht van LINQ naar XML

Van toepassing op

Save(Stream, SaveOptions)

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Hiermee wordt dit XStreamingElement 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 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:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Serialiseer dit streaming-element naar een TextWriter, optioneel uitschakelen van 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 XStreamingElement met opmaak.

XElement srcTree = new XElement("Root",
                       new XElement("Child", 1),
                       new XElement("Child", 2),
                       new XElement("Child", 3),
                       new XElement("Child", 4),
                       new XElement("Child", 5)
                   );

XStreamingElement dstTree = new XStreamingElement("NewRoot",
                        from el in srcTree.Elements()
                        where (int)el == 3
                        select new XElement("DifferentChild", (int)el)
                    );

StringBuilder sb = new StringBuilder();
dstTree.Save(new StringWriter(sb), SaveOptions.DisableFormatting);
Console.WriteLine(sb.ToString());
Console.WriteLine("------");
sb = new StringBuilder();
dstTree.Save(new StringWriter(sb), SaveOptions.None);
Console.WriteLine(sb.ToString());

Dim srcTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot", _
                        From el In srcTree.Elements() _
                        Where el.Value = 3 _
                        Select <DifferentChild><%= el.Value %></DifferentChild> _
                    )

Dim sb As StringBuilder = New StringBuilder()
dstTree.Save(New StringWriter(sb), SaveOptions.DisableFormatting)
Console.WriteLine(sb.ToString())
Console.WriteLine("------")
sb = New StringBuilder()
dstTree.Save(New StringWriter(sb), SaveOptions.None)
Console.WriteLine(sb.ToString())

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

<?xml version="1.0" encoding="utf-16"?><NewRoot><DifferentChild>3</DifferentChild></NewRoot>
------
<?xml version="1.0" encoding="utf-16"?>
<NewRoot>
  <DifferentChild>3</DifferentChild>
</NewRoot>

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:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Bron:: XStreamingElement.cs

Serialiseer dit streaming-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 object dat 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 XStreamingElement met opmaak.

XElement srcTree = new XElement("Root",
                       new XElement("Child", 1),
                       new XElement("Child", 2),
                       new XElement("Child", 3),
                       new XElement("Child", 4),
                       new XElement("Child", 5)
                   );

XStreamingElement dstTree = new XStreamingElement("NewRoot",
                        from el in srcTree.Elements()
                        where (int)el == 3
                        select new XElement("DifferentChild", (int)el)
                    );

dstTree.Save("Test1.xml", SaveOptions.DisableFormatting);
dstTree.Save("Test2.xml", SaveOptions.None);
Console.WriteLine(File.ReadAllText("Test1.xml"));
Console.WriteLine("------");
Console.WriteLine(File.ReadAllText("Test2.xml"));

Dim srcTree As XElement = _
    <Root>
        <Child>1</Child>
        <Child>2</Child>
        <Child>3</Child>
        <Child>4</Child>
        <Child>5</Child>
    </Root>

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot", _
                        From el In srcTree.Elements() _
                        Where el.Value = 3 _
                        Select <DifferentChild><%= el.Value %></DifferentChild> _
                    )

dstTree.Save("Test1.xml", SaveOptions.DisableFormatting)
dstTree.Save("Test2.xml", SaveOptions.None)
Console.WriteLine(File.ReadAllText("Test1.xml"))
Console.WriteLine("------")
Console.WriteLine(File.ReadAllText("Test2.xml"))

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

<?xml version="1.0" encoding="utf-8"?><NewRoot><DifferentChild>3</DifferentChild></NewRoot>
------
<?xml version="1.0" encoding="utf-8"?>
<NewRoot>
  <DifferentChild>3</DifferentChild>
</NewRoot>

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?