XStreamingElement.Save Metod

Definition

Namnområde:: System.Xml.Linq

Sammansättningar:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Sammansättningar:: netstandard.dll, System.Xml.XDocument.dll

Sammansättning:: System.Xml.XDocument.dll

Sammansättning:: System.Xml.Linq.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Serialisera det här strömningselementet. Utdata kan sparas i en fil, en XmlTextWriter, en TextWritereller en XmlWriter. Du kan också inaktivera formatering (indrag).

Överlagringar

Name	Description
Save(Stream)	Matar ut detta XStreamingElement till den angivna Stream.
Save(TextWriter)	Serialisera det här strömmande elementet till en TextWriter.
Save(String)	Serialisera det här strömmande elementet till en fil.
Save(XmlWriter)	Serialisera det här strömmande elementet till en XmlWriter.
Save(Stream, SaveOptions)	Matar ut detta XStreamingElement till angivet Stream, om du vill ange formateringsbeteende.
Save(TextWriter, SaveOptions)	Serialisera det här strömningselementet till en TextWriter, om du vill inaktivera formatering.
Save(String, SaveOptions)	Serialisera det här strömmande elementet till en fil, om du vill inaktivera formatering.

Save(Stream)

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Matar ut detta XStreamingElement till den angivna 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)

Parametrar

stream: Stream

Strömmen som ska matas ut XDocument till.

Kommentarer

Den serialiserade XML-koden kommer att dras in. Allt oviktigt tomt utrymme tas bort och ytterligare tomt utrymme läggs till så att XML-koden blir korrekt indragen. Beteendet för den här metoden är att obetydligt tomt utrymme inte bevaras.

Om du vill styra tomt utrymme använder du överlagringen av Save som tar SaveOptions som en parameter. Använd alternativet DisableFormatting för att spara xml-kod som inte har använts. Detta gör att skrivaren skriver alla blanksteg exakt som de visas i XML-trädet.

Använd OmitDuplicateNamespaces alternativet om du vill ta bort duplicerade namnområdesdeklarationer.

Gäller för

Save(TextWriter)

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Serialisera det här strömmande elementet till en 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)

Parametrar

textWriter: TextWriter

A TextWriter som XStreamingElement ska skrivas till.

Exempel

I följande exempel skapas ett XML-källträd och sedan en instans av en XStreamingElement med hjälp av en fråga i XML-källträdet. Den skriver sedan strömningselementet till en 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())

Det här exemplet genererar följande utdata:

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

Kommentarer

Om du vill styra tomt utrymme använder du en av överlagringarna av Save det som tar SaveOptions som en parameter. Mer information finns i Bevara tomt utrymme vid inläsning eller parsning av XML och Bevara tomt utrymme vid serialisering.

Se även

Översikt över LINQ till XML

Gäller för

Save(String)

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Serialisera det här strömmande elementet till en fil.

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

public void Save(string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

Parametrar

fileName: String

En String som innehåller namnet på filen.

Exempel

I följande exempel skapas ett strömmande XML-träd. Sedan serialiseras det strömmande XML-trädet till en fil.

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

Det här exemplet genererar följande utdata:

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

Kommentarer

Se även

Översikt över LINQ till XML

Gäller för

Save(XmlWriter)

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Serialisera det här strömmande elementet till en 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)

Parametrar

writer: XmlWriter

A XmlWriter som XElement ska skrivas till.

Exempel

I följande exempel skapas en XStreamingElement och skrivs till en XmlWriter.

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

Det här exemplet genererar följande utdata:

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

Se även

Översikt över LINQ till XML

Gäller för

Save(Stream, SaveOptions)

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Matar ut detta XStreamingElement till angivet Stream, om du vill ange formateringsbeteende.

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)

Parametrar

stream: Stream

Strömmen som ska matas ut XDocument till.

options: SaveOptions

Ett SaveOptions objekt som anger formateringsbeteende.

Kommentarer

Som standard options är de inställda på None. Det här alternativet tar bort allt överflödigt tomt utrymme och lägger till lämpligt obetydligt tomt utrymme så att XML:en är korrekt indragen.

Om du vill spara unindented XML anger du DisableFormatting flaggan för options. Detta gör att skrivaren skriver alla blanksteg exakt som de visas i XML-trädet.

Använd OmitDuplicateNamespaces alternativet om du vill ta bort duplicerade namnområdesdeklarationer.

Gäller för

Save(TextWriter, SaveOptions)

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Serialisera det här strömningselementet till en TextWriter, om du vill inaktivera formatering.

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)

Parametrar

textWriter: TextWriter

Att TextWriter mata ut XML till.

options: SaveOptions

En SaveOptions som anger formateringsbeteende.

Exempel

I följande exempel visas två användningsområden för den här metoden. Den första användningen bevarar tomt utrymme. Den andra serialiserar XStreamingElement med formatering.

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

Det här exemplet genererar följande utdata:

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

Kommentarer

Om du vill spara unindented XML anger du DisableFormatting flaggan för options. Detta gör att skrivaren skriver allt tomt utrymme exakt som det representeras i XML-trädet.

Om du vill spara indragad XML anger du DisableFormatting inte flaggan för options. Detta tar bort allt överflödigt oviktigt tomt utrymme och lägger till lämpligt obetydligt tomt utrymme så att XML:en är korrekt indragen. Det här är standardbeteendet och beteendet för överlagringarna av de Save metoder som inte tar options som en parameter.

Mer information finns i Bevara tomt utrymme vid inläsning eller parsning av XML och Bevara tomt utrymme vid serialisering.

Se även

Översikt över LINQ till XML

Gäller för

Save(String, SaveOptions)

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Källa:: XStreamingElement.cs

Serialisera det här strömmande elementet till en fil, om du vill inaktivera formatering.

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)

Parametrar

fileName: String

En String som innehåller namnet på filen.

options: SaveOptions

Ett SaveOptions objekt som anger formateringsbeteende.

Exempel

I följande exempel visas två användningsområden för den här metoden. Den första användningen bevarar tomt utrymme. Den andra serialiserar XStreamingElement med formatering.

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

Det här exemplet genererar följande utdata:

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

Kommentarer

Om du vill spara unindented XML anger du DisableFormatting flaggan för options. Detta gör att skrivaren skriver allt tomt utrymme exakt som det representeras i XML-trädet.

Mer information finns i Bevara tomt utrymme vid inläsning eller parsning av XML och Bevara tomt utrymme vid serialisering.

Se även

Översikt över LINQ till XML

Gäller för

Feedback

Var den här sidan till hjälp?