다음을 통해 공유


XmlWriter.Create 메서드

정의

XmlWriter 인스턴스를 만듭니다.

오버로드

Create(StringBuilder, XmlWriterSettings)

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

Create(String, XmlWriterSettings)

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

Create(TextWriter, XmlWriterSettings)

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

Create(Stream, XmlWriterSettings)

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

Create(XmlWriter, XmlWriterSettings)

지정된 XmlWriterXmlWriter 개체를 사용하여 새 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)

XmlWriterStringBuilder 개체를 사용하여 새 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이 사용됩니다.

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

반환

XmlWriter

XmlWriter 개체입니다.

예외

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이 사용됩니다.

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

반환

XmlWriter

XmlWriter 개체입니다.

예외

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)

XmlWriterTextWriter 개체를 사용하여 새 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이 사용됩니다.

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

반환

XmlWriter

XmlWriter 개체입니다.

예외

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이 사용됩니다.

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

반환

XmlWriter

XmlWriter 개체입니다.

예외

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)

지정된 XmlWriterXmlWriter 개체를 사용하여 새 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이 사용됩니다.

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

반환

XmlWriter

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

예외

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 개체입니다.

예외

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는 지정된 경로에 파일을 만들어 XML 1.0 텍스트 구문으로 해당 파일에 씁니다. outputFileName은 파일 시스템 경로여야 합니다.

반환

XmlWriter

XmlWriter 개체입니다.

예외

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

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

적용 대상

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 개체입니다.

예외

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 개체입니다.

예외

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

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

또한 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 개체입니다.

예외

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

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

적용 대상