XmlDocument.Save Metod

Definition

Namnområde:: System.Xml

Sammansättningar:: System.Xml.dll, System.Xml.XmlDocument.dll

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

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

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

Sammansättning:: System.Xml.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.

Sparar XML-dokumentet på den angivna platsen.

Överlagringar

Name	Description
Save(Stream)	Sparar XML-dokumentet i den angivna strömmen.
Save(TextWriter)	Sparar XML-dokumentet till den angivna TextWriter.
Save(String)	Sparar XML-dokumentet i den angivna filen. Om den angivna filen finns skriver den här metoden över den.
Save(XmlWriter)	Sparar XML-dokumentet till den angivna XmlWriter.

Save(Stream)

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Sparar XML-dokumentet i den angivna strömmen.

public:
 virtual void Save(System::IO::Stream ^ outStream);

public virtual void Save(System.IO.Stream outStream);

abstract member Save : System.IO.Stream -> unit
override this.Save : System.IO.Stream -> unit

Public Overridable Sub Save (outStream As Stream)

Parametrar

outStream: Stream

Dataströmmen som du vill spara till.

Undantag

XmlException

Åtgärden skulle inte resultera i ett välformat XML-dokument (till exempel inget dokumentelement eller duplicerade XML-deklarationer).

Kommentarer

Tomt utrymme bevaras endast om PreserveWhitespace är inställt på true.

XmlDeclaration för det aktuella XmlDocument objektet avgör kodningsattributet i det sparade dokumentet. Värdet för kodningsattributet hämtas från XmlDeclaration.Encoding egenskapen. XmlDocument Om inte har en XmlDeclaration, eller om XmlDeclaration inte har ett kodningsattribut, kommer det sparade dokumentet inte heller att ha något.

När dokumentet sparas genereras xmlns-attribut för att bevara nodidentiteten (lokalt namn + namnområdes-URI) på rätt sätt. Följande C#-kod

XmlDocument doc = new XmlDocument();
doc.AppendChild(doc.CreateElement("item","urn:1"));
doc.Save(Console.Out);

genererar det här xmls-attributet <item xmls="urn:1"/>.

Den här metoden är ett Microsoft-tillägg till dokumentobjektmodellen (DOM).

Observera att endast Save metoden framtvingar ett välformat XML-dokument. Alla andra Save överlagringar garanterar endast ett välformat fragment.

Gäller för

Save(TextWriter)

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Sparar XML-dokumentet till den angivna TextWriter.

public:
 virtual void Save(System::IO::TextWriter ^ writer);

public virtual void Save(System.IO.TextWriter writer);

abstract member Save : System.IO.TextWriter -> unit
override this.Save : System.IO.TextWriter -> unit

Public Overridable Sub Save (writer As TextWriter)

Parametrar

writer: TextWriter

Den TextWriter som du vill spara till.

Undantag

XmlException

Åtgärden skulle inte resultera i ett välformat XML-dokument (till exempel inget dokumentelement eller duplicerade XML-deklarationer).

Kommentarer

Kodningen på TextWriter bestämmer den kodning som skrivs ut (Kodningen av XmlDeclaration-noden ersätts av kodningen av TextWriter). Om det inte fanns någon kodning angiven på TextWriterXmlDocument , sparas den utan ett kodningsattribut.

Den här metoden är ett Microsoft-tillägg till dokumentobjektmodellen (DOM).

Observera att endast Save metoden framtvingar ett välformat XML-dokument. Alla andra Save överlagringar garanterar endast ett välformat fragment.

Gäller för

Save(String)

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Sparar XML-dokumentet i den angivna filen. Om den angivna filen finns skriver den här metoden över den.

public:
 virtual void Save(System::String ^ filename);

public virtual void Save(string filename);

abstract member Save : string -> unit
override this.Save : string -> unit

Public Overridable Sub Save (filename As String)

Parametrar

filename: String

Platsen för filen där du vill spara dokumentet.

Undantag

XmlException

Åtgärden skulle inte resultera i ett välformat XML-dokument (till exempel inget dokumentelement eller duplicerade XML-deklarationer).

Exempel

I följande exempel läses XML in i ett XmlDocument-objekt, ändras och sparas sedan i en fil med namnet data.xml.

using System;
using System.Xml;

public class Sample {

  public static void Main() {

    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<item><name>wrench</name></item>");

    // Add a price element.
    XmlElement newElem = doc.CreateElement("price");
    newElem.InnerText = "10.95";
    doc.DocumentElement.AppendChild(newElem);

    // Save the document to a file. White space is
    // preserved (no white space).
    doc.PreserveWhitespace = true;
    doc.Save("data.xml");
  }
}

Imports System.Xml

public class Sample 

  public shared sub Main() 
 
    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<item><name>wrench</name></item>")

    ' Add a price element.
    Dim newElem as XmlElement = doc.CreateElement("price")
    newElem.InnerText = "10.95"
    doc.DocumentElement.AppendChild(newElem)

    ' Save the document to a file. White space is
    ' preserved (no white space).
    doc.PreserveWhitespace = true
    doc.Save("data.xml")
 
  end sub
end class

Filen data.xml innehåller följande XML: <item><name>wrench</name><price>10.95</price></item>.

Kommentarer

Tomt utrymme bevaras endast i utdatafilen om PreserveWhitespace är inställt på true.

När dokumentet sparas genereras xmlns-attribut för att bevara nodidentiteten (lokalt namn + namnområdes-URI) på rätt sätt. Följande C#-kod

XmlDocument doc = new XmlDocument();
doc.AppendChild(doc.CreateElement("item","urn:1"));
doc.Save(Console.Out);

genererar det här xmls-attributet <item xmls="urn:1"/>.

Den här metoden är ett Microsoft-tillägg till dokumentobjektmodellen (DOM).

Observera att endast Save metoden framtvingar ett välformat XML-dokument. Alla andra Save överlagringar garanterar endast ett välformat fragment.

Gäller för

Save(XmlWriter)

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Sparar XML-dokumentet till den angivna XmlWriter.

public:
 virtual void Save(System::Xml::XmlWriter ^ w);

public virtual void Save(System.Xml.XmlWriter w);

abstract member Save : System.Xml.XmlWriter -> unit
override this.Save : System.Xml.XmlWriter -> unit

Public Overridable Sub Save (w As XmlWriter)

Parametrar

w: XmlWriter

Den XmlWriter som du vill spara till.

Undantag

XmlException

Åtgärden skulle inte resultera i ett välformat XML-dokument (till exempel inget dokumentelement eller duplicerade XML-deklarationer).

Exempel

I följande exempel läses XML in i ett XmlDocument objekt och sparas det i en fil.

using System;
using System.Xml;

public class Sample {

  public static void Main() {

    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<item><name>wrench</name></item>");

   // Add a price element.
   XmlElement newElem = doc.CreateElement("price");
   newElem.InnerText = "10.95";
   doc.DocumentElement.AppendChild(newElem);

   XmlWriterSettings settings = new XmlWriterSettings();
   settings.Indent = true;
   // Save the document to a file and auto-indent the output.
   XmlWriter writer = XmlWriter.Create("data.xml", settings);
    doc.Save(writer);
  }
}

Imports System.Xml

public class Sample 

  public shared sub Main() 
 
    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<item><name>wrench</name></item>")

   ' Add a price element.
   Dim newElem as XmlElement = doc.CreateElement("price")
   newElem.InnerText = "10.95"
   doc.DocumentElement.AppendChild(newElem)

   Dim settings As New XmlWriterSettings()
   settings.Indent = True
   ' Save the document to a file and auto-indent the output.
   Dim writer As XmlWriter = XmlWriter.Create("data.xml", settings)
    doc.Save(writer)
  end sub
end class

Kommentarer

Tomt utrymme bevaras endast om PreserveWhitespace är inställt på true.

Kodningen på XmlWriter bestämmer den kodning som skrivs ut (Kodningen av XmlDeclaration-noden ersätts av kodningen av XmlWriter). Om det inte fanns någon kodning angiven på XmlWriterXmlDocument , sparas den utan ett kodningsattribut.

När dokumentet sparas genereras xmlns-attribut för att bevara nodidentiteten (LocalName + NamespaceURI) på rätt sätt. Följande C#-kod

XmlDocument doc = new XmlDocument();
doc.AppendChild(doc.CreateElement("item","urn:1"));
doc.Save(Console.Out);

genererar det här XML-attributet:

<item
    xmls="urn:1"/>

Den här metoden är ett Microsoft-tillägg till dokumentobjektmodellen (DOM).

Observera att endast Save metoden framtvingar ett välformat XML-dokument. Alla andra Save överlagringar garanterar endast ett välformat fragment.

Se även

Formatting

Gäller för

Feedback

Var den här sidan till hjälp?