XElement.Save XElement.Save XElement.Save XElement.Save Method

정의

이 요소의 내부 XML 트리를 serialize합니다.Serialize this element's underlying XML tree. 출력을 파일, XmlTextWriter, TextWriter 또는 XmlWriter로 저장할 수 있습니다.The output can be saved to a file, an XmlTextWriter, a TextWriter, or an XmlWriter. 또한 형식 지정(들여쓰기)을 선택적으로 해제할 수 있습니다.Optionally, formatting (indenting) can be disabled.

오버로드

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

XElement를 지정된 Stream에 출력합니다.Outputs this XElement to the specified Stream.

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

이 요소를 TextWriter로 serialize합니다.Serialize this element to a TextWriter.

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

이 요소를 파일로 serialize합니다.Serialize this element to a file.

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

이 요소를 XmlWriter로 serialize합니다.Serialize this element to an XmlWriter.

Save(Stream, SaveOptions) Save(Stream, SaveOptions) Save(Stream, SaveOptions)

XElement를 지정된 Stream에 출력하고 선택적으로 형식 지정 동작을 지정합니다.Outputs this XElement to the specified Stream, optionally specifying formatting behavior.

Save(TextWriter, SaveOptions) Save(TextWriter, SaveOptions) Save(TextWriter, SaveOptions)

이 요소를 TextWriter로 serialize하고, 선택적으로 형식 지정을 해제합니다.Serialize this element to a TextWriter, optionally disabling formatting.

Save(String, SaveOptions) Save(String, SaveOptions) Save(String, SaveOptions) Save(String, SaveOptions)

이 요소를 파일로 serialize하고, 선택적으로 형식 지정을 해제합니다.Serialize this element to a file, optionally disabling formatting.

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

XElement를 지정된 Stream에 출력합니다.Outputs this XElement to the specified Stream.

public:
 void Save(System::IO::Stream ^ stream);
public void Save (System.IO.Stream stream);
member this.Save : System.IO.Stream -> unit

매개 변수

stream
Stream Stream Stream Stream

XElement를 출력할 스트림입니다.The stream to output this XElement to.

설명

Serialize 된 XML은 들여씁니다.The serialized XML will be indented. 모든 무효 공백이 제거할 수 있으며, XML을 올바르게 들여쓰기 됩니다 있도록 추가 공백이 추가 됩니다.All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. 이 메서드의 동작은 불필요 한 공백이 유지 되지 것입니다.The behavior of this method is that insignificant white space will not be preserved.

오버 로드를 사용 하 여 공백 제어 하려는 경우 Save 를 사용 하는 SaveOptions 매개 변수로 합니다.If you want to control white space, use the overload of Save that takes SaveOptions as a parameter. 사용 된 DisableFormatting 된 들여쓰지 않은 XML을 저장 하는 옵션입니다.Use the DisableFormatting option to save unindented XML. 이렇게 하면 모든 공백이 XML 트리에 표시 된 대로 정확 하 게 작성할 작성기입니다.This will cause the writer to write all white spaces exactly as represented in the XML tree.

사용 된 OmitDuplicateNamespaces 중복 된 네임 스페이스 선언을 제거 하려는 경우 옵션입니다.Use the OmitDuplicateNamespaces option if you want to remove duplicate namespace declarations.

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

이 요소를 TextWriter로 serialize합니다.Serialize this element to a TextWriter.

public:
 void Save(System::IO::TextWriter ^ textWriter);
public void Save (System.IO.TextWriter textWriter);
member this.Save : System.IO.TextWriter -> unit

매개 변수

textWriter
TextWriter TextWriter TextWriter TextWriter

TextWriter를 쓸 XElement입니다.A TextWriter that the XElement will be written to.

예제

다음 예제에서는 XElement, 문서를 저장을 StringWriter, 한 다음 콘솔에 문자열을 출력 합니다.The following example creates an XElement, saves the document to a StringWriter, and then prints the string to the console.

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  

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

Serialize 된 XML은 들여씁니다.The serialized XML will be indented. 모든 무효 공백이 제거할 수 있으며, XML을 올바르게 들여쓰기 됩니다 있도록 추가 공백이 추가 됩니다.All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. 이 메서드의 동작은 공백이 유지 되지 것입니다.The behavior of this method is that white space will not be preserved.

오버 로드를 사용 하 여 공백 제어 하려는 경우 Save 지정할 수 있도록 SaveOptions 매개 변수로 합니다.If you want to control white space, use the overload of Save that allows you to specify SaveOptions as a parameter. 자세한 내용은 로드 하거나 XML 구문 분석 하는 동안 공백을 유지 하 고 유지 공백 하는 동안 직렬화합니다.For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

추가 정보

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

이 요소를 파일로 serialize합니다.Serialize this element to a file.

public:
 void Save(System::String ^ fileName);
public void Save (string fileName);
member this.Save : string -> unit
Public Sub Save (fileName As String)

매개 변수

fileName
String String String String

파일 이름이 들어 있는 String입니다.A String that contains the name of the file.

예제

다음 예제에서는 XElement, 문서 파일에 저장 한 다음 콘솔 파일을 출력 합니다.The following example creates an XElement, saves the document to a file, and then prints the file to the console.

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)  

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

Serialize 된 XML은 들여씁니다.The serialized XML will be indented. 모든 무효 공백이 제거할 수 있으며, XML을 올바르게 들여쓰기 됩니다 있도록 추가 공백이 추가 됩니다.All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. 이 메서드의 동작은 무효 공백이 XML 트리에서 노드를 유지 되지 것입니다.The behavior of this method is that insignificant white space nodes in the XML tree will not be preserved.

오버 로드를 사용 하 여 공백 제어 하려는 경우 Save 지정할 수 있도록 SaveOptions 매개 변수로 합니다.If you want to control white space, use the overload of Save that allows you to specify SaveOptions as a parameter. 자세한 내용은 로드 하거나 XML 구문 분석 하는 동안 공백을 유지 하 고 유지 공백 하는 동안 직렬화합니다.For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

추가 정보

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

이 요소를 XmlWriter로 serialize합니다.Serialize this element to an 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)

매개 변수

writer
XmlWriter XmlWriter XmlWriter XmlWriter

XmlWriter를 쓸 XElement입니다.A XmlWriter that the XElement will be written to.

예제

다음 예제에서는 XElementXmlWriter에 저장하는 방법을 보여 줍니다.The following example shows how to save an XElement to an 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())  

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

<Root><Child>child content</Child></Root>  
추가 정보

Save(Stream, SaveOptions) Save(Stream, SaveOptions) Save(Stream, SaveOptions)

XElement를 지정된 Stream에 출력하고 선택적으로 형식 지정 동작을 지정합니다.Outputs this XElement to the specified Stream, optionally specifying formatting behavior.

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

매개 변수

stream
Stream Stream Stream Stream

XElement를 출력할 스트림입니다.The stream to output this XElement to.

options
SaveOptions SaveOptions SaveOptions SaveOptions

서식 지정 동작을 지정하는 SaveOptions 개체입니다.A SaveOptions object that specifies formatting behavior.

설명

기본적으로는 options 로 설정 되어 None입니다.By default the options are set to None. 이 옵션은 모든 불필요 한 공백이 제거 하 고 XML이 제대로 들여쓰는 지 수 있도록 적절 한 무효 공백을 추가 합니다.This option will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented.

지정 된 들여쓰지 않은 XML을 저장 하려는 경우는 DisableFormatting 플래그 options합니다.If you want to save unindented XML, specify the DisableFormatting flag for options. 이렇게 하면 모든 공백이 XML 트리에 표시 된 대로 정확 하 게 작성할 작성기입니다.This will cause the writer to write all white spaces exactly as represented in the XML tree.

사용 하 여 OmitDuplicateNamespaces 중복 된 네임 스페이스 선언을 제거 하려는 경우 옵션입니다.Use OmitDuplicateNamespaces option if you want to remove duplicate namespace declarations.

Save(TextWriter, SaveOptions) Save(TextWriter, SaveOptions) Save(TextWriter, SaveOptions)

이 요소를 TextWriter로 serialize하고, 선택적으로 형식 지정을 해제합니다.Serialize this element to a TextWriter, optionally disabling formatting.

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

매개 변수

textWriter
TextWriter TextWriter TextWriter TextWriter

XML을 출력할 TextWriter입니다.The TextWriter to output the XML to.

options
SaveOptions SaveOptions SaveOptions SaveOptions

형식 지정 동작을 지정하는 SaveOptions입니다.A SaveOptions that specifies formatting behavior.

예제

다음 예제에서는이 메서드의 두 가지 용도 보여 줍니다.The following example shows two uses of this method. 첫 번째 사용에서는 공백을 유지합니다.The first use preserves white space. 두 번째 serialize 된 XElement 서식을 사용 하 여 합니다.The second serializes the XElement with formatting. 문서에는 공백이 없습니다 생성, 때문에 들여쓰기 되지 않고 XML 출력 공백 유지 합니다.Because the document has no white space in it as constructed, preserving white space outputs the XML without any indenting.

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  

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

지정 된 들여쓰지 않은 XML을 저장 하려는 경우는 DisableFormatting 플래그 options합니다.If you want to save unindented XML, specify the DisableFormatting flag for options. 이렇게 하면 모든 공백이 XML 트리에 표시 된 대로 정확 하 게 작성할 작성기입니다.This will cause the writer to write all white space exactly as represented in the XML tree.

들여쓰기 된 XML을 저장 하려는 경우를 지정 하지 않으면 합니다 DisableFormatting 플래그 options합니다.If you want to save indented XML, do not specify the DisableFormatting flag for options. 모든 불필요 한 공백이 제거 되 고 XML이 제대로 들여쓰는 지 수 있도록 적절 한 불필요 한 공백이 추가 됩니다.This will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented. 이 기본 동작을 오버 로드의 동작을 Save 사용 하지 않는 메서드 options 매개 변수로 합니다.This is the default behavior, and the behavior of the overloads of the Save methods that do not take options as a parameter.

자세한 내용은 로드 하거나 XML 구문 분석 하는 동안 공백을 유지 하 고 유지 공백 하는 동안 직렬화합니다.For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

추가 정보

Save(String, SaveOptions) Save(String, SaveOptions) Save(String, SaveOptions) Save(String, SaveOptions)

이 요소를 파일로 serialize하고, 선택적으로 형식 지정을 해제합니다.Serialize this element to a file, optionally disabling formatting.

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)

매개 변수

fileName
String String String String

파일 이름이 들어 있는 String입니다.A String that contains the name of the file.

options
SaveOptions SaveOptions SaveOptions SaveOptions

형식 지정 동작을 지정하는 SaveOptions입니다.A SaveOptions that specifies formatting behavior.

예제

다음 예제에서는이 메서드의 두 가지 용도 보여 줍니다.The following example shows two uses of this method. 첫 번째 사용에서는 공백을 유지합니다.The first use preserves white space. 두 번째 serialize 된 XElement 서식을 사용 하 여 합니다.The second one serializes the XElement with formatting.

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)  

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

지정 된 들여쓰지 않은 XML을 저장 하려는 경우는 DisableFormatting 플래그 options합니다.If you want to save unindented XML, specify the DisableFormatting flag for options. 이렇게 하면 모든 공백이 XML 트리에 표시 된 대로 정확 하 게 작성할 작성기입니다.This will cause the writer to write all white space exactly as represented in the XML tree.

들여쓰기 된 XML을 저장 하려는 경우를 지정 하지 않으면 합니다 DisableFormatting 플래그 options합니다.If you want to save indented XML, do not specify the DisableFormatting flag for options. 모든 불필요 한 공백이 제거 되 고 XML이 제대로 들여쓰는 지 수 있도록 적절 한 불필요 한 공백이 추가 됩니다.This will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented. 이 기본 동작을 오버 로드의 동작을 Save 사용 하지 않는 메서드 options 매개 변수로 합니다.This is the default behavior, and the behavior of the overloads of the Save methods that do not take options as a parameter.

자세한 내용은 로드 하거나 XML 구문 분석 하는 동안 공백을 유지 하 고 유지 공백 하는 동안 직렬화합니다.For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

추가 정보

적용 대상