XmlWriter.Create Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Membuat instans XmlWriter baru.

Overload

Nama	Deskripsi
Create(StringBuilder, XmlWriterSettings)	Membuat instans baru XmlWriter menggunakan StringBuilder objek dan XmlWriterSettings .
Create(String, XmlWriterSettings)	Membuat instans baru XmlWriter menggunakan nama file dan XmlWriterSettings objek.
Create(TextWriter, XmlWriterSettings)	Membuat instans baru XmlWriter menggunakan TextWriter objek dan XmlWriterSettings .
Create(Stream, XmlWriterSettings)	Membuat instans baru XmlWriter menggunakan aliran dan XmlWriterSettings objek.
Create(XmlWriter, XmlWriterSettings)	Membuat instans baru XmlWriter menggunakan objek dan XmlWriter yang ditentukanXmlWriterSettings.
Create(StringBuilder)	Membuat instans baru XmlWriter menggunakan StringBuilder.
Create(String)	Membuat instans baru XmlWriter menggunakan nama file yang ditentukan.
Create(TextWriter)	Membuat instans baru XmlWriter menggunakan TextWriter.
Create(Stream)	Membuat instans baru XmlWriter menggunakan aliran yang ditentukan.
Create(XmlWriter)	Membuat instans baru XmlWriter menggunakan objek yang ditentukan XmlWriter .

Keterangan

Create Beberapa kelebihan beban menyertakan settings parameter yang menerima XmlWriterSettings objek. Anda dapat menggunakan objek ini untuk:

• Tentukan fitur mana yang ingin Didukung pada objek yang dibuat XmlWriter .

• Gunakan XmlWriterSettings kembali objek untuk membuat beberapa objek penulis. Objek XmlWriterSettings disalin dan ditandai baca-saja untuk setiap penulis yang dibuat. Perubahan pada pengaturan pada XmlWriterSettings instans tidak memengaruhi penulis yang ada dengan pengaturan yang sama. Dengan demikian, Anda dapat menggunakan pengaturan yang sama untuk membuat beberapa penulis dengan fungsionalitas yang sama. Atau, Anda dapat mengubah pengaturan pada XmlWriterSettings instans dan membuat penulis baru dengan serangkaian fitur yang berbeda.

• Tambahkan fitur ke penulis XML yang sudah ada. Metode Create ini dapat menerima objek lain XmlWriter . Objek yang mendasar XmlWriter tidak harus menjadi penulis XML yang dibuat oleh metode statis Create . Misalnya, Anda dapat menentukan penulis XML yang ditentukan pengguna untuk menambahkan fitur tambahan.

• Manfaatkan sepenuhnya fitur seperti pemeriksaan kesamaan yang lebih baik dan kepatuhan terhadap rekomendasi XML 1.0 yang hanya tersedia pada XmlWriter objek yang dibuat oleh metode statis Create .

Jika Anda menggunakan Create kelebihan beban yang tidak menerima XmlWriterSettings objek, pengaturan penulis default berikut digunakan:

Setting	Default
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dua spasi
NamespaceHandling	Default (tidak ada penghapusan)
NewLineChars	\r\n (carriage return, line feed) untuk platform non-Unix, atau \n (umpan baris) untuk platform Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Note

Meskipun .NET Framework mencakup kelas XmlTextWriter, yang merupakan implementasi konkret dari kelas XmlWriter, kami sarankan Anda membuat instans XmlWriter dengan menggunakan metode Create.

Create(StringBuilder, XmlWriterSettings)

Sumber:

XmlWriter.cs

Membuat instans baru XmlWriter menggunakan StringBuilder objek dan 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);

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

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

Parameter

output

StringBuilder

yang StringBuilder akan ditulis. Konten yang XmlWriter ditulis oleh ditambahkan ke StringBuilder.

settings

XmlWriterSettings

Objek yang XmlWriterSettings digunakan untuk mengonfigurasi instans baru XmlWriter . Jika ini adalah null, XmlWriterSettings dengan pengaturan default digunakan.

XmlWriter Jika sedang digunakan dengan Transform(String, XmlWriter) metode , Anda harus menggunakan OutputSettings properti untuk mendapatkan objek dengan pengaturan yang XmlWriterSettings benar. Ini memastikan bahwa objek yang dibuat XmlWriter memiliki pengaturan output yang benar.

Mengembalikan

XmlWriter

Sebuah objekXmlWriter.

Pengecualian

ArgumentNullException

output adalah null.

Create(String, XmlWriterSettings)

Sumber:

XmlWriter.cs

Membuat instans baru XmlWriter menggunakan nama file dan XmlWriterSettings objek.

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

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

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

Parameter

outputFileName

String

File yang ingin Anda tulis. XmlWriter membuat file di jalur yang ditentukan dan menulisnya dalam sintaks teks XML 1.0. outputFileName harus berupa jalur sistem file.

settings

XmlWriterSettings

Objek yang XmlWriterSettings digunakan untuk mengonfigurasi instans baru XmlWriter . Jika ini adalah null, XmlWriterSettings dengan pengaturan default digunakan.

XmlWriter Jika sedang digunakan dengan Transform(String, XmlWriter) metode , Anda harus menggunakan OutputSettings properti untuk mendapatkan objek dengan pengaturan yang XmlWriterSettings benar. Ini memastikan bahwa objek yang dibuat XmlWriter memiliki pengaturan output yang benar.

Mengembalikan

XmlWriter

Sebuah objekXmlWriter.

Pengecualian

ArgumentNullException

outputFileName adalah null.

Contoh

Contoh berikut membuat XmlWriter objek dengan pengaturan yang ditentukan.

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)

Sumber:

XmlWriter.cs

Membuat instans baru XmlWriter menggunakan TextWriter objek dan 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);

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

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

Parameter

output

TextWriter

yang TextWriter ingin Anda tulis. Sintaks XmlWriter teks XML 1.0 tulis dan menambahkannya ke yang ditentukan TextWriter.

settings

XmlWriterSettings

Objek yang XmlWriterSettings digunakan untuk mengonfigurasi instans baru XmlWriter . Jika ini adalah null, XmlWriterSettings dengan pengaturan default digunakan.

XmlWriter Jika sedang digunakan dengan Transform(String, XmlWriter) metode , Anda harus menggunakan OutputSettings properti untuk mendapatkan objek dengan pengaturan yang XmlWriterSettings benar. Ini memastikan bahwa objek yang dibuat XmlWriter memiliki pengaturan output yang benar.

Mengembalikan

XmlWriter

Sebuah objekXmlWriter.

Pengecualian

ArgumentNullException

output adalah null.

Contoh

Contoh berikut menulis string 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)

Sumber:

XmlWriter.cs

Membuat instans baru XmlWriter menggunakan aliran dan XmlWriterSettings objek.

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

Parameter

output

Stream

Aliran yang ingin Anda tulis. Menulis XmlWriter sintaks teks XML 1.0 dan menambahkannya ke aliran yang ditentukan.

settings

XmlWriterSettings

Objek yang XmlWriterSettings digunakan untuk mengonfigurasi instans baru XmlWriter . Jika ini adalah null, XmlWriterSettings dengan pengaturan default digunakan.

XmlWriter Jika sedang digunakan dengan Transform(String, XmlWriter) metode , Anda harus menggunakan OutputSettings properti untuk mendapatkan objek dengan pengaturan yang XmlWriterSettings benar. Ini memastikan bahwa objek yang dibuat XmlWriter memiliki pengaturan output yang benar.

Mengembalikan

XmlWriter

Sebuah objekXmlWriter.

Pengecualian

ArgumentNullException

output adalah null.

Contoh

Contoh berikut menulis fragmen XML ke aliran memori.

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.

Keterangan

XmlWriter selalu menulis Byte Order Mark (BOM) ke aliran data yang mendasar; namun, beberapa aliran tidak boleh memiliki BOM. Untuk menghilangkan BOM, buat objek baru XmlWriterSettings dan atur properti Pengodean menjadi objek baru UTF8Encoding dengan nilai Boolean di konstruktor yang diatur ke false.

Create(XmlWriter, XmlWriterSettings)

Sumber:

XmlWriter.cs

Membuat instans baru XmlWriter menggunakan objek dan XmlWriter yang ditentukanXmlWriterSettings.

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

Parameter

output

XmlWriter

Objek XmlWriter yang ingin Anda gunakan sebagai penulis yang mendasar.

settings

XmlWriterSettings

Objek yang XmlWriterSettings digunakan untuk mengonfigurasi instans baru XmlWriter . Jika ini adalah null, XmlWriterSettings dengan pengaturan default digunakan.

XmlWriter Jika sedang digunakan dengan Transform(String, XmlWriter) metode , Anda harus menggunakan OutputSettings properti untuk mendapatkan objek dengan pengaturan yang XmlWriterSettings benar. Ini memastikan bahwa objek yang dibuat XmlWriter memiliki pengaturan output yang benar.

Mengembalikan

XmlWriter

Objek XmlWriter yang dibungkus di sekitar objek yang ditentukan XmlWriter .

Pengecualian

ArgumentNullException

output adalah null.

Keterangan

Metode ini memungkinkan Anda menambahkan fitur tambahan ke objek yang mendasar XmlWriter . Objek yang mendasar XmlWriter dapat menjadi objek yang dibuat oleh XmlWriter.Create metode , atau objek yang dibuat menggunakan XmlTextWriter implementasi .

Create(StringBuilder)

Sumber:

XmlWriter.cs

Membuat instans baru XmlWriter menggunakan 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

Parameter

output

StringBuilder

yang StringBuilder akan ditulis. Konten yang XmlWriter ditulis oleh ditambahkan ke StringBuilder.

Mengembalikan

XmlWriter

Sebuah objekXmlWriter.

Pengecualian

ArgumentNullException

output adalah null.

Keterangan

Saat Anda menggunakan kelebihan beban ini, XmlWriterSettings objek dengan pengaturan default digunakan untuk membuat penulis XML.

Setting	Default
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dua spasi
NamespaceHandling	Default (tidak ada penghapusan)
NewLineChars	\r\n (carriage return, line feed) untuk platform non-Unix, atau \n (umpan baris) untuk platform Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Jika Anda ingin menentukan fitur yang akan didukung pada penulis XML yang dibuat, gunakan kelebihan beban yang mengambil XmlWriterSettings objek sebagai salah satu argumennya, dan meneruskan XmlWriterSettings objek dengan pengaturan kustom Anda.

Create(String)

Sumber:

XmlWriter.cs

Membuat instans baru XmlWriter menggunakan nama file yang ditentukan.

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

Parameter

outputFileName

String

File yang ingin Anda tulis. XmlWriter membuat file di jalur yang ditentukan dan menulisnya dalam sintaks teks XML 1.0. outputFileName harus berupa jalur sistem file.

Mengembalikan

XmlWriter

Sebuah objekXmlWriter.

Pengecualian

ArgumentNullException

outputFileName adalah null.

Contoh

Contoh berikut membuat XmlWriter objek dan menulis simpul buku.

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

Keterangan

Saat Anda menggunakan kelebihan beban ini, XmlWriterSettings objek dengan pengaturan default digunakan untuk membuat penulis XML.

Setting	Default
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dua spasi
NamespaceHandling	Default (tidak ada penghapusan)
NewLineChars	\r\n (carriage return, line feed) untuk platform non-Unix, atau \n (umpan baris) untuk platform Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Jika Anda ingin menentukan fitur yang akan didukung pada penulis XML yang dibuat, gunakan kelebihan beban yang mengambil XmlWriterSettings objek sebagai salah satu argumennya, dan meneruskan XmlWriterSettings objek dengan pengaturan kustom Anda.

Create(TextWriter)

Sumber:

XmlWriter.cs

Membuat instans baru XmlWriter menggunakan 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

Parameter

output

TextWriter

yang TextWriter ingin Anda tulis. Sintaks XmlWriter teks XML 1.0 tulis dan menambahkannya ke yang ditentukan TextWriter.

Mengembalikan

XmlWriter

Sebuah objekXmlWriter.

Pengecualian

ArgumentNullException

output adalah null.

Contoh

Contoh berikut membuat penulis yang menghasilkan ke konsol.

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

Keterangan

Saat Anda menggunakan kelebihan beban ini, XmlWriterSettings objek dengan pengaturan default digunakan untuk membuat penulis XML.

Setting	Default
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dua spasi
NamespaceHandling	Default (tidak ada penghapusan)
NewLineChars	\r\n (carriage return, line feed) untuk platform non-Unix, atau \n (umpan baris) untuk platform Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Jika Anda ingin menentukan fitur yang akan didukung pada penulis yang dibuat, gunakan kelebihan beban yang mengambil XmlWriterSettings objek sebagai salah satu argumennya, dan meneruskan XmlWriterSettings objek dengan pengaturan kustom Anda.

Create(Stream)

Sumber:

XmlWriter.cs

Membuat instans baru XmlWriter menggunakan aliran yang ditentukan.

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

Parameter

output

Stream

Aliran yang ingin Anda tulis. Menulis XmlWriter sintaks teks XML 1.0 dan menambahkannya ke aliran yang ditentukan.

Mengembalikan

XmlWriter

Sebuah objekXmlWriter.

Pengecualian

ArgumentNullException

output adalah null.

Contoh

Contoh berikut menulis fragmen XML ke aliran memori. (Ini menggunakan Create(Stream, XmlWriterSettings) kelebihan beban, yang juga mengonfigurasi pengaturan pada instans penulis XML baru.)

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.

Keterangan

Saat Anda menggunakan kelebihan beban ini, XmlWriterSettings objek dengan pengaturan default berikut digunakan untuk membuat penulis XML:

Setting	Default
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dua spasi
NamespaceHandling	Default (tidak ada penghapusan)
NewLineChars	\r\n (carriage return, line feed) untuk platform non-Unix, atau \n (umpan baris) untuk platform Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Jika Anda ingin menentukan fitur yang akan didukung pada penulis yang dibuat, gunakan kelebihan beban yang mengambil XmlWriterSettings objek sebagai salah satu argumennya, dan meneruskan XmlWriterSettings objek dengan pengaturan kustom Anda.

Selain itu, XmlWriter selalu menulis Byte Order Mark (BOM) ke aliran data yang mendasar; namun, beberapa aliran tidak boleh memiliki BOM. Untuk menghilangkan BOM, buat objek baru XmlWriterSettings dan atur properti Pengodean menjadi objek baru UTF8Encoding dengan nilai Boolean di konstruktor yang diatur ke false.

Create(XmlWriter)

Sumber:

XmlWriter.cs

Membuat instans baru XmlWriter menggunakan objek yang ditentukan 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

Parameter

output

XmlWriter

Objek XmlWriter yang ingin Anda gunakan sebagai penulis yang mendasar.

Mengembalikan

XmlWriter

Objek XmlWriter yang dibungkus di sekitar objek yang ditentukan XmlWriter .

Pengecualian

ArgumentNullException

output adalah null.

Keterangan

Metode ini memungkinkan Anda menambahkan fitur ke objek yang mendasar XmlWriter . Objek yang mendasar XmlWriter dapat menjadi objek yang dibuat oleh XmlWriter.Create metode , atau objek yang dibuat menggunakan XmlTextWriter implementasi .

Saat Anda menggunakan kelebihan beban ini, XmlWriterSettings objek dengan pengaturan default digunakan untuk membuat penulis XML.

Setting	Default
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dua spasi
NamespaceHandling	Default (tidak ada penghapusan)
NewLineChars	\r\n (carriage return, line feed) untuk platform non-Unix, atau \n (umpan baris) untuk platform Unix
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Jika Anda ingin menentukan fitur yang akan didukung pada penulis XML yang dibuat, gunakan kelebihan beban yang mengambil XmlWriterSettings objek sebagai salah satu argumennya, dan meneruskan XmlWriterSettings objek dengan pengaturan kustom Anda.