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 yang XmlWriterSettings digunakan untuk membuat instans ini XmlWriter .
WriteState	Ketika ditimpa di kelas turunan, mendapatkan status penulis.
XmlLang	Ketika ditimpa di kelas turunan, mendapatkan cakupan saat ini xml:lang .
XmlSpace	Ketika ditimpa di kelas turunan, mendapatkan yang XmlSpace mewakili cakupan saat ini xml:space .

Metode

Close()	Ketika ditimpa di kelas turunan, menutup aliran ini dan aliran yang mendasar.
Create(Stream)	Membuat instans baru XmlWriter menggunakan aliran yang ditentukan.
Create(Stream, XmlWriterSettings)	Membuat instans baru XmlWriter menggunakan aliran dan XmlWriterSettings objek.
Create(String)	Membuat instans baru XmlWriter menggunakan nama file yang ditentukan.
Create(String, XmlWriterSettings)	Membuat instans baru XmlWriter menggunakan nama file dan XmlWriterSettings objek.
Create(StringBuilder)	Membuat instans baru XmlWriter menggunakan yang ditentukan StringBuilder.
Create(StringBuilder, XmlWriterSettings)	Membuat instans baru XmlWriter menggunakan StringBuilder objek dan XmlWriterSettings .
Create(TextWriter)	Membuat instans baru XmlWriter menggunakan yang ditentukan TextWriter.
Create(TextWriter, XmlWriterSettings)	Membuat instans baru XmlWriter menggunakan TextWriter objek dan XmlWriterSettings .
Create(XmlWriter)	Membuat instans baru XmlWriter menggunakan objek yang ditentukan XmlWriter .
Create(XmlWriter, XmlWriterSettings)	Membuat instans baru XmlWriter menggunakan objek dan XmlWriterSettings yang ditentukanXmlWriter.
Dispose()	Merilis semua sumber daya yang digunakan oleh instans XmlWriter kelas saat ini.
Dispose(Boolean)	Merilis sumber daya tidak terkelola 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 mengalirkan apa pun yang ada di buffer ke aliran yang mendasar dan juga membersihkan aliran yang mendasar.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type 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 saat ini Object. (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 menulis semua atribut yang ditemukan pada posisi saat ini di XmlReader.
WriteAttributeString(String, String)	Saat ditimpa di kelas turunan, tulis atribut dengan nama dan nilai lokal yang ditentukan.
WriteAttributeString(String, String, String)	Saat ditimpa di kelas turunan, tulis atribut dengan nama lokal, URI namespace, dan nilai yang ditentukan.
WriteAttributeString(String, String, String, String)	Saat ditimpa di kelas turunan, tulis atribut dengan awalan, nama lokal, URI namespace layanan, dan nilai yang ditentukan.
WriteAttributeStringAsync(String, String, String, String)	Secara asinkron menulis atribut dengan awalan, nama lokal, URI namespace layanan, dan nilai yang ditentukan.
WriteBase64(Byte[], Int32, Int32)	Ketika 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)	Ketika ditimpa di 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 menuliskan teks yang dihasilkan.
WriteCData(String)	Ketika ditimpa di kelas turunan, tulis ! <[ CDATA[...]]> blok berisi teks yang ditentukan.
WriteCDataAsync(String)	Secara asinkron menulis ! <[ CDATA[...]]> blok berisi teks yang ditentukan.
WriteCharEntity(Char)	Saat ditimpa di 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 sekalian.
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 menulis 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 layanan, dan nilai yang ditentukan.
WriteElementStringAsync(String, String, String, String)	Secara asinkron menulis elemen dengan awalan, nama lokal, URI namespace layanan, dan nilai yang ditentukan.
WriteEndAttribute()	Saat ditimpa di kelas turunan, menutup panggilan sebelumnya WriteStartAttribute(String, String) .
WriteEndAttributeAsync()	Menutup panggilan sebelumnya WriteStartAttribute(String, String) secara asinkron.
WriteEndDocument()	Ketika ditimpa di kelas turunan, menutup elemen atau atribut 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 di 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 di kelas turunan, tulis referensi entitas sebagai &name;.
WriteEntityRefAsync(String)	Secara asinkron menulis referensi entitas sebagai &name;.
WriteFullEndElement()	Saat ditimpa di 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, tulis 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).
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 di kelas turunan, tulis nama yang ditentukan, memastikannya adalah NmToken yang valid sesuai dengan rekomendasi W3C XML 1.0 (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 W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNode(XmlReader, Boolean)	Ketika ditimpa di kelas turunan, menyalin semuanya dari pembaca ke penulis dan memindahkan pembaca ke awal saudara kandung berikutnya.
WriteNode(XPathNavigator, Boolean)	Menyalin semuanya dari XPathNavigator objek ke penulis. Posisi tetap XPathNavigator 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 XPathNavigator objek ke penulis. Posisi tetap XPathNavigator tidak berubah.
WriteProcessingInstruction(String, String)	Ketika ditimpa di kelas turunan, tulis instruksi pemrosesan dengan spasi antara nama dan teks sebagai berikut: <?name text?>.
WriteProcessingInstructionAsync(String, String)	Secara asinkron menulis instruksi pemrosesan dengan spasi antara nama dan teks sebagai berikut: <?name text?>.
WriteQualifiedName(String, String)	Ketika 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 menulis nama yang memenuhi syarat namespace. Metode ini mencari awalan yang berada dalam cakupan untuk namespace yang diberikan.
WriteRaw(Char[], Int32, Int32)	Saat ditimpa di kelas turunan, tulis markup mentah secara manual dari buffer karakter.
WriteRaw(String)	Saat ditimpa di kelas turunan, tulis markup mentah secara manual dari string.
WriteRawAsync(Char[], Int32, Int32)	Secara asinkron menulis markup mentah secara manual dari buffer karakter.
WriteRawAsync(String)	Secara asinkron menulis markup mentah 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 awal 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 di kelas turunan, tulis deklarasi XML dengan versi "1.0".
WriteStartDocument(Boolean)	Saat ditimpa di kelas turunan, tulis deklarasi XML dengan versi "1.0" dan atribut mandiri.
WriteStartDocumentAsync()	Secara asinkron menulis deklarasi XML 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, tulis tag mulai yang ditentukan dan kaitkan dengan namespace yang diberikan.
WriteStartElement(String, String, String)	Saat ditimpa di kelas turunan, tulis tag mulai yang ditentukan dan kaitkan 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, tulis konten teks yang diberikan.
WriteStringAsync(String)	Secara asinkron menulis konten teks yang diberikan.
WriteSurrogateCharEntity(Char, Char)	Ketika 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)	Boolean Menulis nilai.
WriteValue(DateTime)	DateTime Menulis nilai.
WriteValue(DateTimeOffset)	DateTimeOffset Menulis nilai.
WriteValue(Decimal)	Decimal Menulis nilai.
WriteValue(Double)	Double Menulis nilai.
WriteValue(Int32)	Int32 Menulis nilai.
WriteValue(Int64)	Int64 Menulis nilai.
WriteValue(Object)	Menulis nilai objek.
WriteValue(Single)	Menulis angka floating-point presisi tunggal.
WriteValue(String)	String Menulis nilai.
WriteWhitespace(String)	Ketika ditimpa di kelas turunan, tulis ruang putih 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 dilakukan.

Lihat juga

• Dokumen dan Data XML