XmlWriter.Create 메서드

참조

정의

네임스페이스:: System.Xml

어셈블리:: System.Xml.ReaderWriter.dll

어셈블리:: System.Xml.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

새 XmlWriter 인스턴스를 만듭니다.

오버로드

Create(StringBuilder, XmlWriterSettings)	XmlWriter 및 StringBuilder 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.
Create(String, XmlWriterSettings)	파일 이름과 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.
Create(TextWriter, XmlWriterSettings)	XmlWriter 및 TextWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.
Create(Stream, XmlWriterSettings)	스트림과 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.
Create(XmlWriter, XmlWriterSettings)	지정된 XmlWriter 및 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.
Create(StringBuilder)	지정된 XmlWriter를 사용하여 새 StringBuilder 인스턴스를 만듭니다.
Create(String)	지정된 파일 이름을 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(TextWriter)	지정된 XmlWriter를 사용하여 새 TextWriter 인스턴스를 만듭니다.
Create(Stream)	지정된 스트림을 사용하여 새 XmlWriter 인스턴스를 만듭니다.
Create(XmlWriter)	지정된 XmlWriter 개체를 사용하여 새 XmlWriter 인스턴스를 만듭니다.

설명

Create 일부 오버로드에는 개체를 settings 허용하는 매개 변수가 포함됩니다XmlWriterSettings. 이 개체를 사용하여 다음을 수행할 수 있습니다.

만든 XmlWriter 개체에서 지원하려는 기능을 지정합니다.
개체를 XmlWriterSettings 다시 사용하여 여러 기록기 개체를 만듭니다. 개체가 XmlWriterSettings 복사되고 생성된 각 작성기에 대해 읽기 전용으로 표시됩니다. 인스턴스의 설정을 변경해도 동일한 설정을 XmlWriterSettings 가진 기존 작성기에는 영향을 미치지 않습니다. 따라서 동일한 설정을 사용하여 동일한 기능을 가진 여러 작성기를 만들 수 있습니다. 또는 인스턴스의 설정을 XmlWriterSettings 수정하고 다른 기능 집합을 사용하여 새 작성기를 만들 수 있습니다.
기존 XML 작성기에 기능을 추가합니다. 메서드는 Create 다른 XmlWriter 개체를 허용할 수 있습니다. 기본 XmlWriter 개체는 정적 Create 메서드에서 만든 XML 작성기일 필요가 없습니다. 예를 들어 추가 기능을 추가할 사용자 정의 XML 작성기를 지정할 수 있습니다.
정적 Create 메서드에서 만든 개체에서만 XmlWriter 사용할 수 있는 더 나은 규칙 검사 및 XML 1.0 권장 사항 준수와 같은 기능을 최대한 활용합니다.

개체를 Create 허용하지 않는 오버로드를 XmlWriterSettings 사용하는 경우 다음 기본 작성기 설정이 사용됩니다.

설정	기본값
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	두 개의 공백
NamespaceHandling	Default (제거 안 됨)
NewLineChars	`\r\n` (캐리지 리턴, 새 줄)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

참고

.NET Framework 클래스의 XmlTextWriter 구체적인 구현인 클래스를 XmlWriter 포함하지만 메서드를 사용하여 Create 인스턴스를 만드는 XmlWriter 것이 좋습니다.

Create(StringBuilder, XmlWriterSettings)

XmlWriter 및 StringBuilder 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.

public:
 static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output, System.Xml.XmlWriterSettings? settings);

static member Create : System.Text.StringBuilder * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As StringBuilder, settings As XmlWriterSettings) As XmlWriter

매개 변수

output: StringBuilder

쓰기에 사용할 StringBuilder입니다. XmlWriter가 쓰는 콘텐츠는 StringBuilder에 추가됩니다.

settings: XmlWriterSettings

새 XmlWriterSettings 인스턴스를 구성하는 데 사용되는 XmlWriter 개체입니다. 값이 null이면 기본 설정이 지정된 XmlWriterSettings이 사용됩니다.

XmlWriter가 Transform(String, XmlWriter) 메서드와 함께 사용되는 경우 OutputSettings 속성을 사용하여 올바른 설정을 포함하는 XmlWriterSettings 개체를 가져와야 합니다. 이에 따라 만들어진 XmlWriter 개체가 올바른 출력 설정을 갖게 됩니다.

반환

XmlWriter

XmlWriter 개체입니다.

예외

ArgumentNullException

builder 값이 null입니다.

적용 대상

Create(String, XmlWriterSettings)

파일 이름과 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.

public:
 static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (string outputFileName, System.Xml.XmlWriterSettings? settings);

public static System.Xml.XmlWriter Create (string outputFileName, System.Xml.XmlWriterSettings settings);

static member Create : string * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (outputFileName As String, settings As XmlWriterSettings) As XmlWriter

매개 변수

outputFileName: String

쓰기에 사용할 파일입니다. XmlWriter는 지정된 경로에 파일을 만들어 XML 1.0 텍스트 구문으로 해당 파일에 씁니다. outputFileName은 파일 시스템 경로여야 합니다.

settings: XmlWriterSettings

새 XmlWriterSettings 인스턴스를 구성하는 데 사용되는 XmlWriter 개체입니다. 값이 null이면 기본 설정이 지정된 XmlWriterSettings이 사용됩니다.

반환

XmlWriter

XmlWriter 개체입니다.

예외

ArgumentNullException

url 값이 null입니다.

예제

다음 예제에서는 정의된 설정을 사용하여 XmlWriter 개체를 만듭니다.

using System;
using System.IO;
using System.Xml;
using System.Text;

public class Sample {

  public static void Main() {

    XmlWriter writer = null;

    try {

       // Create an XmlWriterSettings object with the correct options.
       XmlWriterSettings settings = new XmlWriterSettings();
       settings.Indent = true;
       settings.IndentChars = ("\t");
       settings.OmitXmlDeclaration = true;

       // Create the XmlWriter object and write some content.
       writer = XmlWriter.Create("data.xml", settings);
       writer.WriteStartElement("book");
       writer.WriteElementString("item", "tesing");
       writer.WriteEndElement();
    
       writer.Flush();
     }
     finally  {
        if (writer != null)
          writer.Close();
     }
  }
}

Imports System.IO
Imports System.Xml
Imports System.Text

Public Class Sample 

  Public Shared Sub Main() 
  
    Dim writer As XmlWriter = Nothing

    Try 

       ' Create an XmlWriterSettings object with the correct options. 
       Dim settings As XmlWriterSettings = New XmlWriterSettings()
       settings.Indent = true
       settings.IndentChars = (ControlChars.Tab)
       settings.OmitXmlDeclaration = true

       ' Create the XmlWriter object and write some content.
       writer = XmlWriter.Create("data.xml", settings)
       writer.WriteStartElement("book")
       writer.WriteElementString("item", "tesing")
       writer.WriteEndElement()
    
       writer.Flush()

      Finally
         If Not (writer Is Nothing) Then
            writer.Close()
         End If
      End Try

   End Sub 
End Class

적용 대상

Create(TextWriter, XmlWriterSettings)

XmlWriter 및 TextWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.

public:
 static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.IO.TextWriter output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.IO.TextWriter output, System.Xml.XmlWriterSettings? settings);

static member Create : System.IO.TextWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As TextWriter, settings As XmlWriterSettings) As XmlWriter

매개 변수

output: TextWriter

쓰기에 사용할 TextWriter입니다. XmlWriter는 XML 1.0 텍스트 구문을 작성한 후 지정된 TextWriter에 추가합니다.

settings: XmlWriterSettings

새 XmlWriterSettings 인스턴스를 구성하는 데 사용되는 XmlWriter 개체입니다. 값이 null이면 기본 설정이 지정된 XmlWriterSettings이 사용됩니다.

반환

XmlWriter

XmlWriter 개체입니다.

예외

ArgumentNullException

text 값이 null입니다.

예제

다음 예제에서는 XML 문자열을 작성합니다.

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
StringWriter sw = new StringWriter();

using (XmlWriter writer = XmlWriter.Create(sw, settings))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();

    String output = sw.ToString();
}

Dim settings As New XmlWriterSettings()
settings.OmitXmlDeclaration = True
Dim sw As New StringWriter()
        
Using writer As XmlWriter = XmlWriter.Create(sw, settings)
  writer.WriteStartElement("book")
  writer.WriteElementString("price", "19.95")
  writer.WriteEndElement()
  writer.Flush()
            
  Dim output As String = sw.ToString()
End Using

적용 대상

Create(Stream, XmlWriterSettings)

스트림과 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.

public:
 static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.IO.Stream output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.IO.Stream output, System.Xml.XmlWriterSettings? settings);

static member Create : System.IO.Stream * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As Stream, settings As XmlWriterSettings) As XmlWriter

매개 변수

output: Stream

작성하려는 스트림입니다. XmlWriter는 XML 1.0 텍스트 구문을 작성한 후 지정된 스트림에 추가합니다.

settings: XmlWriterSettings

새 XmlWriterSettings 인스턴스를 구성하는 데 사용되는 XmlWriter 개체입니다. 값이 null이면 기본 설정이 지정된 XmlWriterSettings이 사용됩니다.

반환

XmlWriter

XmlWriter 개체입니다.

예외

ArgumentNullException

stream 값이 null입니다.

예제

다음 예제에서는 메모리 스트림에 XML 조각을 씁니다.

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();

// Do additional processing on the stream.

Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false

' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()

' Do additional processing on the stream.

설명

XmlWriter는 항상 BOM(바이트 순서 표시)을 기본 데이터 스트림에 씁니다. 그러나 일부 스트림에는 BOM이 없어야 합니다. BOM을 생략하려면 새 XmlWriterSettings 개체를 만들고 생성자의 부울 값이 false로 설정된 새 UTF8Encoding 개체로 인코딩 속성을 설정합니다.

적용 대상

Create(XmlWriter, XmlWriterSettings)

지정된 XmlWriter 및 XmlWriter 개체를 사용하여 새 XmlWriterSettings 인스턴스를 만듭니다.

public:
 static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output, System::Xml::XmlWriterSettings ^ settings);

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output, System.Xml.XmlWriterSettings settings);

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output, System.Xml.XmlWriterSettings? settings);

static member Create : System.Xml.XmlWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter

Public Shared Function Create (output As XmlWriter, settings As XmlWriterSettings) As XmlWriter

매개 변수

output: XmlWriter

내부 작성기로 사용할 XmlWriter 개체입니다.

settings: XmlWriterSettings

새 XmlWriterSettings 인스턴스를 구성하는 데 사용되는 XmlWriter 개체입니다. 값이 null이면 기본 설정이 지정된 XmlWriterSettings이 사용됩니다.

반환

XmlWriter

지정된 XmlWriter 개체를 래핑하는 XmlWriter 개체입니다.

예외

ArgumentNullException

writer 값이 null입니다.

설명

이 메서드를 사용하면 기본 개체에 추가 기능을 추가할 수 있습니다 XmlWriter . 기본 XmlWriter 개체는 메서드에서 만든 개체이거나 구현을 XmlWriter.Create 사용하여 만든 개체일 XmlTextWriter 수 있습니다.

적용 대상

Create(StringBuilder)

지정된 XmlWriter를 사용하여 새 StringBuilder 인스턴스를 만듭니다.

public:
 static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output);

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output);

static member Create : System.Text.StringBuilder -> System.Xml.XmlWriter

Public Shared Function Create (output As StringBuilder) As XmlWriter

매개 변수

output: StringBuilder

쓰기에 사용할 StringBuilder입니다. XmlWriter가 쓰는 콘텐츠는 StringBuilder에 추가됩니다.

반환

XmlWriter

XmlWriter 개체입니다.

예외

ArgumentNullException

builder 값이 null입니다.

설명

이 오버로드를 사용하면 기본 설정이 있는 XmlWriterSettings 개체가 XML 작성기를 만드는 데 사용됩니다.

설정	기본값
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	두 개의 공백
NamespaceHandling	Default (제거 안 됨)
NewLineChars	`\r\n` (캐리지 리턴, 새 줄)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

만든 XML 작성기에서 지원할 기능을 지정하려면 개체를 인수 중 하나로 사용하는 XmlWriterSettings 오버로드를 사용하고 사용자 지정 설정을 사용하여 개체를 XmlWriterSettings 전달합니다.

적용 대상

Create(String)

지정된 파일 이름을 사용하여 새 XmlWriter 인스턴스를 만듭니다.

public:
 static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName);

public static System.Xml.XmlWriter Create (string outputFileName);

static member Create : string -> System.Xml.XmlWriter

Public Shared Function Create (outputFileName As String) As XmlWriter

매개 변수

outputFileName: String

반환

XmlWriter

XmlWriter 개체입니다.

예외

ArgumentNullException

url 값이 null입니다.

예제

다음 예제에서는 개체를 XmlWriter 만들고 책 노드를 작성합니다.

using (XmlWriter writer = XmlWriter.Create("output.xml"))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();
}

Using writer As XmlWriter = XmlWriter.Create("output.xml")
  writer.WriteStartElement("book")
  writer.WriteElementString("price", "19.95")
  writer.WriteEndElement()
  writer.Flush()
End Using

설명

이 오버로드를 사용하면 기본 설정이 있는 XmlWriterSettings 개체가 XML 작성기를 만드는 데 사용됩니다.

설정	기본값
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	두 개의 공백
NamespaceHandling	Default (제거 안 됨)
NewLineChars	`\r\n` (캐리지 리턴, 새 줄)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

적용 대상

Create(TextWriter)

지정된 XmlWriter를 사용하여 새 TextWriter 인스턴스를 만듭니다.

public:
 static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output);

public static System.Xml.XmlWriter Create (System.IO.TextWriter output);

static member Create : System.IO.TextWriter -> System.Xml.XmlWriter

Public Shared Function Create (output As TextWriter) As XmlWriter

매개 변수

output: TextWriter

쓰기에 사용할 TextWriter입니다. XmlWriter는 XML 1.0 텍스트 구문을 작성한 후 지정된 TextWriter에 추가합니다.

반환

XmlWriter

XmlWriter 개체입니다.

예외

ArgumentNullException

text 값이 null입니다.

예제

다음 예제에서는 콘솔에 출력하는 작성기를 만듭니다.

using (XmlWriter writer = XmlWriter.Create(Console.Out))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();
}

Using writer As XmlWriter = XmlWriter.Create(Console.Out)
  writer.WriteStartElement("book")
  writer.WriteElementString("price", "19.95")
  writer.WriteEndElement()
  writer.Flush()
End Using

설명

이 오버로드를 사용하면 기본 설정이 있는 XmlWriterSettings 개체가 XML 작성기를 만드는 데 사용됩니다.

설정	기본값
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	두 개의 공백
NamespaceHandling	Default (제거 안 됨)
NewLineChars	`\r\n` (캐리지 리턴, 새 줄)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

만든 작성기에서 지원할 기능을 지정하려면 개체를 인수 중 하나로 사용하는 XmlWriterSettings 오버로드를 사용하고 사용자 지정 설정을 사용하여 개체를 XmlWriterSettings 전달합니다.

적용 대상

Create(Stream)

지정된 스트림을 사용하여 새 XmlWriter 인스턴스를 만듭니다.

public:
 static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output);

public static System.Xml.XmlWriter Create (System.IO.Stream output);

static member Create : System.IO.Stream -> System.Xml.XmlWriter

Public Shared Function Create (output As Stream) As XmlWriter

매개 변수

output: Stream

작성하려는 스트림입니다. XmlWriter는 XML 1.0 텍스트 구문을 작성한 후 지정된 스트림에 추가합니다.

반환

XmlWriter

XmlWriter 개체입니다.

예외

ArgumentNullException

stream 값이 null입니다.

예제

다음 예제에서는 메모리 스트림에 XML 조각을 씁니다. (새 XML 기록기 Create(Stream, XmlWriterSettings) 인스턴스의 설정도 구성하는 오버로드를 사용합니다.)

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();

// Do additional processing on the stream.

Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false

' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()

' Do additional processing on the stream.

설명

이 오버로드 XmlWriterSettings 를 사용하면 다음과 같은 기본 설정이 있는 개체가 XML 작성기를 만드는 데 사용됩니다.

설정	기본값
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	두 개의 공백
NamespaceHandling	Default (제거 안 됨)
NewLineChars	`\r\n` (캐리지 리턴, 새 줄)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

또한 XmlWriter는 항상 BOM(바이트 순서 표시)을 기본 데이터 스트림에 씁니다. 그러나 일부 스트림에는 BOM이 없어야 합니다. BOM을 생략하려면 새 XmlWriterSettings 개체를 만들고 생성자의 부울 값이 false로 설정된 새 UTF8Encoding 개체로 인코딩 속성을 설정합니다.

적용 대상

Create(XmlWriter)

지정된 XmlWriter 개체를 사용하여 새 XmlWriter 인스턴스를 만듭니다.

public:
 static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output);

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output);

static member Create : System.Xml.XmlWriter -> System.Xml.XmlWriter

Public Shared Function Create (output As XmlWriter) As XmlWriter

매개 변수

output: XmlWriter

내부 작성기로 사용할 XmlWriter 개체입니다.

반환

XmlWriter

지정된 XmlWriter 개체를 래핑하는 XmlWriter 개체입니다.

예외

ArgumentNullException

writer 값이 null입니다.

설명

이 메서드를 사용하면 기본 개체에 기능을 추가할 수 있습니다 XmlWriter . 기본 XmlWriter 개체는 메서드에서 만든 개체이거나 구현을 XmlWriter.Create 사용하여 만든 개체일 XmlTextWriter 수 있습니다.

이 오버로드를 사용하면 기본 설정이 있는 XmlWriterSettings 개체가 XML 작성기를 만드는 데 사용됩니다.

설정	기본값
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	두 개의 공백
NamespaceHandling	Default (제거 안 됨)
NewLineChars	`\r\n` (캐리지 리턴, 새 줄)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

적용 대상

XmlWriter.Create 메서드

정의

오버로드

설명

Create(StringBuilder, XmlWriterSettings)

매개 변수

반환

예외

적용 대상

Create(String, XmlWriterSettings)

매개 변수

반환

예외

예제

적용 대상

Create(TextWriter, XmlWriterSettings)

매개 변수

반환

예외

예제

적용 대상

Create(Stream, XmlWriterSettings)

매개 변수

반환

예외

예제

설명

적용 대상

Create(XmlWriter, XmlWriterSettings)

매개 변수

반환

예외

설명

적용 대상

Create(StringBuilder)

매개 변수

반환

예외

설명

적용 대상

Create(String)

매개 변수

반환

예외

예제

설명

적용 대상

Create(TextWriter)

매개 변수

반환

예외

예제

설명

적용 대상

Create(Stream)

매개 변수

반환

예외

예제

설명

적용 대상

Create(XmlWriter)

매개 변수

반환

예외

설명

적용 대상

추가 리소스