XmlWriter Kelas

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Xml.ReaderWriter.dll

Sumber:

XmlWriter.cs

Mewakili penulis yang menyediakan cara cepat, tidak di-cache, dan hanya maju untuk menghasilkan aliran atau file yang berisi data XML.

public ref class XmlWriter abstract : IAsyncDisposable, IDisposable

public abstract class XmlWriter : IAsyncDisposable, IDisposable

type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable

Warisan

Object

XmlWriter

Turunan

System.Xml.XmlDictionaryWriter

System.Xml.XmlTextWriter

System.Xml.Xsl.Runtime.XmlQueryOutput

Penerapan

IDisposable IAsyncDisposable

Contoh

Contoh kode berikut menunjukkan cara menggunakan API asinkron untuk menghasilkan XML.

async Task TestWriter(Stream stream)
{
    XmlWriterSettings settings = new XmlWriterSettings();
    settings.Async = true;

    using (XmlWriter writer = XmlWriter.Create(stream, settings)) {
        await writer.WriteStartElementAsync("pf", "root", "http://ns");
        await writer.WriteStartElementAsync(null, "sub", null);
        await writer.WriteAttributeStringAsync(null, "att", null, "val");
        await writer.WriteStringAsync("text");
        await writer.WriteEndElementAsync();
        await writer.WriteProcessingInstructionAsync("pName", "pValue");
        await writer.WriteCommentAsync("cValue");
        await writer.WriteCDataAsync("cdata value");
        await writer.WriteEndElementAsync();
        await writer.FlushAsync();
    }
}

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat keterangan API Tambahan untuk XmlWriter.

Konstruktor

XmlWriter()

Menginisialisasi instans baru kelas XmlWriter.

Properti

Settings	Mendapatkan objek XmlWriterSettings yang digunakan untuk membuat instans XmlWriter ini.
WriteState	Ketika ditimpa di kelas turunan, mendapatkan status penulis.
XmlLang	Ketika ditimpa di kelas turunan, mendapatkan cakupan xml:lang saat ini.
XmlSpace	Saat ditimpa dalam kelas turunan, mendapatkan XmlSpace yang mewakili cakupan xml:space saat ini.

Metode

Close()	Ketika ditimpa di kelas turunan, menutup aliran ini dan aliran yang mendasar.
Create(Stream)	Membuat instans XmlWriter baru menggunakan aliran yang ditentukan.
Create(Stream, XmlWriterSettings)	Membuat instans XmlWriter baru menggunakan aliran dan objek XmlWriterSettings.
Create(String)	Membuat instans XmlWriter baru menggunakan nama file yang ditentukan.
Create(String, XmlWriterSettings)	Membuat instans XmlWriter baru menggunakan nama file dan objek XmlWriterSettings.
Create(StringBuilder)	Membuat instans XmlWriter baru menggunakan StringBuilderyang ditentukan .
Create(StringBuilder, XmlWriterSettings)	Membuat instans XmlWriter baru menggunakan objek StringBuilder dan XmlWriterSettings.
Create(TextWriter)	Membuat instans XmlWriter baru menggunakan TextWriteryang ditentukan .
Create(TextWriter, XmlWriterSettings)	Membuat instans XmlWriter baru menggunakan objek TextWriter dan XmlWriterSettings.
Create(XmlWriter)	Membuat instans XmlWriter baru menggunakan objek XmlWriter yang ditentukan.
Create(XmlWriter, XmlWriterSettings)	Membuat instans XmlWriter baru menggunakan objek XmlWriter dan XmlWriterSettings yang ditentukan.
Dispose()	Merilis semua sumber daya yang digunakan oleh instans kelas XmlWriter saat ini.
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang digunakan oleh XmlWriter dan secara opsional merilis sumber daya terkelola.
DisposeAsync()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola secara asinkron.
DisposeAsyncCore()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya terkelola secara asinkron.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Flush()	Ketika ditimpa di kelas turunan, siram apa pun yang ada di buffer ke aliran yang mendasar dan juga menyiram aliran yang mendasar.
FlushAsync()	Secara asinkron menyiram apa pun yang ada di buffer ke aliran yang mendasar dan juga menyiram aliran yang mendasar.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
LookupPrefix(String)	Saat ditimpa di kelas turunan, mengembalikan awalan terdekat yang ditentukan dalam cakupan namespace saat ini untuk URI namespace layanan.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
WriteAttributes(XmlReader, Boolean)	Ketika ditimpa di kelas turunan, tulis semua atribut yang ditemukan pada posisi saat ini di XmlReader.
WriteAttributesAsync(XmlReader, Boolean)	Secara asinkron menuliskan semua atribut yang ditemukan pada posisi saat ini di XmlReader.
WriteAttributeString(String, String)	Saat ditimpa dalam kelas turunan, tulis atribut dengan nama dan nilai lokal yang ditentukan.
WriteAttributeString(String, String, String)	Saat ditimpa dalam kelas turunan, menulis atribut dengan nama lokal, URI namespace, dan nilai yang ditentukan.
WriteAttributeString(String, String, String, String)	Saat ditimpa dalam kelas turunan, tulis atribut dengan awalan, nama lokal, URI namespace, dan nilai yang ditentukan.
WriteAttributeStringAsync(String, String, String, String)	Secara asinkron menulis atribut dengan awalan, nama lokal, URI namespace, dan nilai yang ditentukan.
WriteBase64(Byte[], Int32, Int32)	Saat ditimpa dalam kelas turunan, mengodekan byte biner yang ditentukan sebagai Base64 dan menulis teks yang dihasilkan.
WriteBase64Async(Byte[], Int32, Int32)	Secara asinkron mengodekan byte biner yang ditentukan sebagai Base64 dan menulis teks yang dihasilkan.
WriteBinHex(Byte[], Int32, Int32)	Saat ditimpa dalam kelas turunan, mengodekan byte biner yang ditentukan sebagai BinHex dan menulis teks yang dihasilkan.
WriteBinHexAsync(Byte[], Int32, Int32)	Secara asinkron mengodekan byte biner yang ditentukan sebagai BinHex dan menulis teks yang dihasilkan.
WriteCData(String)	Ketika ditimpa di kelas turunan, menulis <! [CDATA[...]]> blok yang berisi teks yang ditentukan.
WriteCDataAsync(String)	Secara asinkron menuliskan <! [CDATA[...]]> blok yang berisi teks yang ditentukan.
WriteCharEntity(Char)	Ketika ditimpa dalam kelas turunan, memaksa pembuatan entitas karakter untuk nilai karakter Unicode yang ditentukan.
WriteCharEntityAsync(Char)	Secara asinkron memaksa pembuatan entitas karakter untuk nilai karakter Unicode yang ditentukan.
WriteChars(Char[], Int32, Int32)	Saat ditimpa di kelas turunan, menulis teks satu buffer pada satu waktu.
WriteCharsAsync(Char[], Int32, Int32)	Secara asinkron menulis teks satu buffer sekaligus.
WriteComment(String)	Saat ditimpa di kelas turunan, tulis komentar <!--...--> berisi teks yang ditentukan.
WriteCommentAsync(String)	Secara asinkron menuliskan komentar <!--...--> berisi teks yang ditentukan.
WriteDocType(String, String, String, String)	Saat ditimpa di kelas turunan, tulis deklarasi DOCTYPE dengan nama dan atribut opsional yang ditentukan.
WriteDocTypeAsync(String, String, String, String)	Secara asinkron menulis deklarasi DOCTYPE dengan nama dan atribut opsional yang ditentukan.
WriteElementString(String, String)	Menulis elemen dengan nama dan nilai lokal yang ditentukan.
WriteElementString(String, String, String)	Menulis elemen dengan nama lokal, URI namespace, dan nilai yang ditentukan.
WriteElementString(String, String, String, String)	Menulis elemen dengan awalan, nama lokal, URI namespace, dan nilai yang ditentukan.
WriteElementStringAsync(String, String, String, String)	Menulis elemen secara asinkron dengan awalan, nama lokal, URI namespace, dan nilai yang ditentukan.
WriteEndAttribute()	Saat ditimpa di kelas turunan, menutup panggilan WriteStartAttribute(String, String) sebelumnya.
WriteEndAttributeAsync()	Menutup panggilan WriteStartAttribute(String, String) sebelumnya secara asinkron.
WriteEndDocument()	Ketika ditimpa di kelas turunan, menutup elemen atau atribut yang terbuka dan menempatkan penulis kembali dalam status Mulai.
WriteEndDocumentAsync()	Secara asinkron menutup elemen atau atribut terbuka apa pun dan menempatkan penulis kembali dalam status Mulai.
WriteEndElement()	Saat ditimpa dalam kelas turunan, menutup satu elemen dan memunculkan cakupan namespace yang sesuai.
WriteEndElementAsync()	Secara asinkron menutup satu elemen dan memunculkan cakupan namespace yang sesuai.
WriteEntityRef(String)	Ketika ditimpa dalam kelas turunan, menulis referensi entitas sebagai &name;.
WriteEntityRefAsync(String)	Secara asinkron menulis referensi entitas sebagai &name;.
WriteFullEndElement()	Saat ditimpa dalam kelas turunan, menutup satu elemen dan memunculkan cakupan namespace yang sesuai.
WriteFullEndElementAsync()	Secara asinkron menutup satu elemen dan memunculkan cakupan namespace yang sesuai.
WriteName(String)	Ketika ditimpa dalam kelas turunan, menuliskan nama yang ditentukan, memastikannya adalah nama yang valid sesuai dengan rekomendasi XML 1.0 W3C (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNameAsync(String)	Secara asinkron menuliskan nama yang ditentukan, memastikannya adalah nama yang valid sesuai dengan rekomendasi W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmToken(String)	Ketika ditimpa dalam kelas turunan, menuliskan nama yang ditentukan, memastikannya adalah NmToken yang valid sesuai dengan rekomendasi XML 1.0 W3C (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmTokenAsync(String)	Secara asinkron menuliskan nama yang ditentukan, memastikannya adalah NmToken yang valid sesuai dengan rekomendasi XML 1.0 W3C (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNode(XmlReader, Boolean)	Ketika ditimpa di kelas turunan, salin semuanya dari pembaca ke penulis dan memindahkan pembaca ke awal saudara kandung berikutnya.
WriteNode(XPathNavigator, Boolean)	Menyalin semuanya dari objek XPathNavigator ke penulis. Posisi XPathNavigator tetap tidak berubah.
WriteNodeAsync(XmlReader, Boolean)	Secara asinkron menyalin semuanya dari pembaca ke penulis dan memindahkan pembaca ke awal saudara kandung berikutnya.
WriteNodeAsync(XPathNavigator, Boolean)	Secara asinkron menyalin semuanya dari objek XPathNavigator ke penulis. Posisi XPathNavigator tetap tidak berubah.
WriteProcessingInstruction(String, String)	Saat ditimpa di kelas turunan, tulis instruksi pemrosesan dengan spasi antara nama dan teks sebagai berikut: <teks ?name?>.
WriteProcessingInstructionAsync(String, String)	Secara asinkron menulis instruksi pemrosesan dengan spasi antara nama dan teks sebagai berikut: <teks ?name?>.
WriteQualifiedName(String, String)	Saat ditimpa di kelas turunan, tulis nama yang memenuhi syarat namespace. Metode ini mencari awalan yang berada dalam cakupan untuk namespace yang diberikan.
WriteQualifiedNameAsync(String, String)	Secara asinkron menuliskan nama yang memenuhi syarat namespace. Metode ini mencari awalan yang berada dalam cakupan untuk namespace yang diberikan.
WriteRaw(Char[], Int32, Int32)	Ketika ditimpa di kelas turunan, menulis markup mentah secara manual dari buffer karakter.
WriteRaw(String)	Saat ditimpa di kelas turunan, menulis markup mentah secara manual dari string.
WriteRawAsync(Char[], Int32, Int32)	Menulis markup mentah secara asinkron secara manual dari buffer karakter.
WriteRawAsync(String)	Menulis markup mentah secara asinkron secara manual dari string.
WriteStartAttribute(String)	Menulis awal atribut dengan nama lokal yang ditentukan.
WriteStartAttribute(String, String)	Menulis awal atribut dengan nama lokal dan URI namespace yang ditentukan.
WriteStartAttribute(String, String, String)	Saat ditimpa di kelas turunan, menulis awalan atribut dengan awalan, nama lokal, dan URI namespace yang ditentukan.
WriteStartAttributeAsync(String, String, String)	Secara asinkron menulis awal atribut dengan awalan, nama lokal, dan URI namespace yang ditentukan.
WriteStartDocument()	Saat ditimpa dalam kelas turunan, menulis deklarasi XML dengan versi "1.0".
WriteStartDocument(Boolean)	Saat ditimpa dalam kelas turunan, menulis deklarasi XML dengan versi "1.0" dan atribut mandiri.
WriteStartDocumentAsync()	Menulis deklarasi XML secara asinkron dengan versi "1.0".
WriteStartDocumentAsync(Boolean)	Secara asinkron menulis deklarasi XML dengan versi "1.0" dan atribut mandiri.
WriteStartElement(String)	Saat ditimpa di kelas turunan, tulis tag mulai dengan nama lokal yang ditentukan.
WriteStartElement(String, String)	Saat ditimpa di kelas turunan, menulis tag mulai yang ditentukan dan mengaitkannya dengan namespace yang diberikan.
WriteStartElement(String, String, String)	Ketika ditimpa dalam kelas turunan, menulis tag mulai yang ditentukan dan mengaitkannya dengan namespace layanan dan awalan yang diberikan.
WriteStartElementAsync(String, String, String)	Secara asinkron menulis tag mulai yang ditentukan dan mengaitkannya dengan namespace dan awalan yang diberikan.
WriteString(String)	Saat ditimpa di kelas turunan, menulis konten teks yang diberikan.
WriteStringAsync(String)	Menulis konten teks yang diberikan secara asinkron.
WriteSurrogateCharEntity(Char, Char)	Saat ditimpa di kelas turunan, menghasilkan dan menulis entitas karakter pengganti untuk pasangan karakter pengganti.
WriteSurrogateCharEntityAsync(Char, Char)	Secara asinkron menghasilkan dan menulis entitas karakter pengganti untuk pasangan karakter pengganti.
WriteValue(Boolean)	Menulis nilai Boolean.
WriteValue(DateTime)	Menulis nilai DateTime.
WriteValue(DateTimeOffset)	Menulis nilai DateTimeOffset.
WriteValue(Decimal)	Menulis nilai Decimal.
WriteValue(Double)	Menulis nilai Double.
WriteValue(Int32)	Menulis nilai Int32.
WriteValue(Int64)	Menulis nilai Int64.
WriteValue(Object)	Menulis nilai objek.
WriteValue(Single)	Menulis angka floating-point presisi tunggal.
WriteValue(String)	Menulis nilai String.
WriteWhitespace(String)	Ketika ditimpa di kelas turunan, menulis ruang kosong yang diberikan.
WriteWhitespaceAsync(String)	Secara asinkron menulis ruang kosong yang diberikan.

Metode Ekstensi

ConfigureAwait(IAsyncDisposable, Boolean)

Mengonfigurasi bagaimana menunggu tugas yang dikembalikan dari asinkron sekali pakai akan dilakukan.

Lihat juga

• Dokumen XML dan Data