XmlDocument.Save XmlDocument.Save XmlDocument.Save XmlDocument.Save Method

정의

XML 문서를 지정된 위치에 저장합니다.Saves the XML document to the specified location.

오버로드

Save(Stream) Save(Stream) Save(Stream) Save(Stream)

XML 문서를 지정된 스트림에 저장합니다.Saves the XML document to the specified stream.

Save(TextWriter) Save(TextWriter) Save(TextWriter) Save(TextWriter)

XML 문서를 지정된 TextWriter에 저장합니다.Saves the XML document to the specified TextWriter.

Save(String) Save(String) Save(String) Save(String)

XML 문서를 지정된 파일에 저장합니다.Saves the XML document to the specified file. 지정한 파일이 존재하면 이 메서드를 덮어씁니다.If the specified file exists, this method overwrites it.

Save(XmlWriter) Save(XmlWriter) Save(XmlWriter) Save(XmlWriter)

XML 문서를 지정된 XmlWriter에 저장합니다.Saves the XML document to the specified XmlWriter.

Save(Stream) Save(Stream) Save(Stream) Save(Stream)

XML 문서를 지정된 스트림에 저장합니다.Saves the XML document to the specified stream.

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)

매개 변수

outStream
Stream Stream Stream Stream

저장할 스트림입니다.The stream to which you want to save.

예외

이 작업을 수행하면 올바른 형식의 XML 문서가 생성되지 않습니다(예: 문서 요소 또는 중복 XML 선언 없음).The operation would not result in a well formed XML document (for example, no document element or duplicate XML declarations).

설명

경우에 공백이 유지 됩니다 PreserveWhitespace 로 설정 된 true합니다.White space is preserved only if PreserveWhitespace is set to true.

현재 XmlDeclaration XmlDocument 개체 인코딩 특성에 저장된 된 문서를 확인 합니다.The XmlDeclaration of the current XmlDocument object determines the encoding attribute in the saved document. 인코딩 특성의 값을 가져옵니다는 XmlDeclaration.Encoding 속성입니다.The value of the encoding attribute is taken from the XmlDeclaration.Encoding property. 경우는 XmlDocument 않습니다 XmlDeclaration, 없거나는 XmlDeclaration 인코딩 특성에 없는 경우 저장된 된 문서 것 하나 중 하나입니다.If the XmlDocument does not have an XmlDeclaration, or if the XmlDeclaration does not have an encoding attribute, the saved document will not have one either.

문서를 저장 하는 경우 (로컬 이름 + 네임 스페이스 URI) 노드 id를 올바르게 유지 하도록 xmlns 특성 생성 됩니다.When the document is saved, xmlns attributes are generated to persist the node identity (local name + namespace URI) correctly. 예를 들어 다음 C# 코드For example, the following C# code

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

이 xml 특성을 생성 <item xmls="urn:1"/>합니다.generates this xmls attribute <item xmls="urn:1"/>.

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

Save 메서드는 올바른 형식의 XML 문서를 적용 합니다.Note that only the Save method enforces a well-formed XML document. 다른 모든 Save 오버 로드는 단편만 잘 구성 된 합니다.All other Save overloads only guarantee a well-formed fragment.

Save(TextWriter) Save(TextWriter) Save(TextWriter) Save(TextWriter)

XML 문서를 지정된 TextWriter에 저장합니다.Saves the XML document to the specified 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)

매개 변수

writer
TextWriter TextWriter TextWriter TextWriter

저장할 대상 TextWriter입니다.The TextWriter to which you want to save.

예외

이 작업을 수행하면 올바른 형식의 XML 문서가 생성되지 않습니다(예: 문서 요소 또는 중복 XML 선언 없음).The operation would not result in a well formed XML document (for example, no document element or duplicate XML declarations).

설명

인코딩을 합니다 TextWriter 기록 되는 인코딩을 결정 (인코딩의 바뀝니다 XmlDeclaration 노드 인코딩는 TextWriter).The encoding on the TextWriter determines the encoding that is written out (The encoding of the XmlDeclaration node is replaced by the encoding of the TextWriter). 있는 경우에 지정 된 인코딩이 합니다 TextWriter, XmlDocument 인코딩 특성이 없는 저장 됩니다.If there was no encoding specified on the TextWriter, the XmlDocument is saved without an encoding attribute.

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

Save 메서드는 올바른 형식의 XML 문서를 적용 합니다.Note that only the Save method enforces a well-formed XML document. 다른 모든 Save 오버 로드는 단편만 잘 구성 된 합니다.All other Save overloads only guarantee a well-formed fragment.

Save(String) Save(String) Save(String) Save(String)

XML 문서를 지정된 파일에 저장합니다.Saves the XML document to the specified file. 지정한 파일이 존재하면 이 메서드를 덮어씁니다.If the specified file exists, this method overwrites it.

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)

매개 변수

filename
String String String String

문서를 저장할 파일의 위치입니다.The location of the file where you want to save the document.

예외

이 작업을 수행하면 올바른 형식의 XML 문서가 생성되지 않습니다(예: 문서 요소 또는 중복 XML 선언 없음).The operation would not result in a well formed XML document (for example, no document element or duplicate XML declarations).

예제

다음 예제에서는 XmlDocument 개체로 XML을 로드 하려면 수정 하 고 data.xml 라는 파일에 저장 합니다.The following example loads XML into an XmlDocument object, modifies it, and then saves it to a file named data.xml.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew 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" );
}

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

Data.xml 파일을 다음 XML이 포함 됩니다. <item><name>wrench</name><price>10.95</price></item>합니다.The data.xml file will contain the following XML: <item><name>wrench</name><price>10.95</price></item>.

설명

경우에만 출력 파일에 공백이 유지 됩니다 PreserveWhitespace 로 설정 된 true합니다.White space is preserved in the output file only if PreserveWhitespace is set to true.

현재 XmlDeclaration XmlDocument 개체 인코딩 특성에 저장된 된 문서를 확인 합니다.The XmlDeclaration of the current XmlDocument object determines the encoding attribute in the saved document. 인코딩 특성의 값을 가져옵니다는 XmlDeclaration.Encoding 속성입니다.The value of the encoding attribute is taken from the XmlDeclaration.Encoding property. 경우는 XmlDocument 않습니다 XmlDeclaration, 없거나는 XmlDeclaration 인코딩 특성에 없는 경우 저장된 된 문서 것 하나 중 하나입니다.If the XmlDocument does not have an XmlDeclaration, or if the XmlDeclaration does not have an encoding attribute, the saved document will not have one either.

문서를 저장 하는 경우 (로컬 이름 + 네임 스페이스 URI) 노드 id를 올바르게 유지 하도록 xmlns 특성 생성 됩니다.When the document is saved, xmlns attributes are generated to persist the node identity (local name + namespace URI) correctly. 예를 들어 다음 C# 코드For example, the following C# code

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

이 xml 특성을 생성 <item xmls="urn:1"/>합니다.generates this xmls attribute <item xmls="urn:1"/>.

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

Save 메서드는 올바른 형식의 XML 문서를 적용 합니다.Note that only the Save method enforces a well-formed XML document. 다른 모든 Save 오버 로드는 단편만 잘 구성 된 합니다.All other Save overloads only guarantee a well-formed fragment.

Save(XmlWriter) Save(XmlWriter) Save(XmlWriter) Save(XmlWriter)

XML 문서를 지정된 XmlWriter에 저장합니다.Saves the XML document to the specified 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)

매개 변수

w
XmlWriter XmlWriter XmlWriter XmlWriter

저장할 대상 XmlWriter입니다.The XmlWriter to which you want to save.

예외

이 작업을 수행하면 올바른 형식의 XML 문서가 생성되지 않습니다(예: 문서 요소 또는 중복 XML 선언 없음).The operation would not result in a well formed XML document (for example, no document element or duplicate XML declarations).

예제

다음 예제에서는 XML을 로드는 XmlDocument 개체 및 파일에 저장 합니다.The following example loads XML into an XmlDocument object and saves it out to a file.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew 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 and auto-indent the output.
   XmlTextWriter^ writer = gcnew XmlTextWriter( "data.xml", nullptr );
   writer->Formatting = Formatting::Indented;
   doc->Save( writer );
}

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

설명

경우에 공백이 유지 됩니다 PreserveWhitespace 로 설정 된 true합니다.White space is preserved only if PreserveWhitespace is set to true.

인코딩을 합니다 XmlWriter 기록 되는 인코딩을 결정 (인코딩의 바뀝니다 XmlDeclaration 노드 인코딩는 XmlWriter).The encoding on the XmlWriter determines the encoding that is written out (The encoding of the XmlDeclaration node is replaced by the encoding of the XmlWriter). 있는 경우에 지정 된 인코딩이 합니다 XmlWriter, XmlDocument 인코딩 특성이 없는 저장 됩니다.If there was no encoding specified on the XmlWriter, the XmlDocument is saved without an encoding attribute.

문서를 저장 하는 경우 xmlns 특성 (LocalName + NamespaceURI) 노드 id를 올바르게 유지 하도록 생성 됩니다.When the document is saved, xmlns attributes are generated to persist the node identity (LocalName + NamespaceURI) correctly. 예를 들어 다음 C# 코드For example, the following C# code

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

이 xml 특성을 생성합니다.generates this xmls attribute:

<item  
    xmls="urn:1"/>  

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

Save 메서드는 올바른 형식의 XML 문서를 적용 합니다.Note that only the Save method enforces a well-formed XML document. 다른 모든 Save 오버 로드는 단편만 잘 구성 된 합니다.All other Save overloads only guarantee a well-formed fragment.

추가 정보

적용 대상