TextWriter Kelas

Referensi

Definisi

Ruang nama:: System.IO

Rakitan:: System.IO.dll

Rakitan:: System.Runtime.dll

Rakitan:: System.Runtime.Extensions.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Sumber:: TextWriter.cs

Sumber:: TextWriter.cs

Sumber:: TextWriter.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili penulis yang dapat menulis serangkaian karakter berurutan. Kelas ini abstrak.

public ref class TextWriter abstract : IDisposable

public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable

public ref class TextWriter abstract : MarshalByRefObject, IDisposable

public abstract class TextWriter : IDisposable

public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable

public abstract class TextWriter : MarshalByRefObject, IDisposable

[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TextWriter : MarshalByRefObject, IDisposable

type TextWriter = class
    interface IDisposable

type TextWriter = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Serializable>]
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class TextWriter
Implements IDisposable

Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable

Warisan: Object
TextWriter

Warisan: Object

MarshalByRefObject
TextWriter

Turunan: System.CodeDom.Compiler.IndentedTextWriter

System.IO.StreamWriter

System.IO.StringWriter

System.Web.HttpWriter

System.Web.UI.HtmlTextWriter

Atribut: SerializableAttribute ComVisibleAttribute

Penerapan: IDisposable IAsyncDisposable

Contoh

Kelas TextWriter ini adalah kelas abstrak. Oleh karena itu, Anda tidak membuat instans dalam kode Anda. Kelas StreamWriter ini berasal dari TextWriter dan menyediakan implementasi anggota untuk menulis ke streaming. Contoh berikut menunjukkan cara menulis dua baris yang terdiri dari nilai string ke file teks dengan menggunakan WriteLineAsync(String) metode .

using System.IO;

namespace ConsoleApplication
{
    class Program4
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync("First line of example");
                await writer.WriteLineAsync("and second line");
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync("First line of example")
            Await writer.WriteLineAsync("and second line")
        End Using
    End Sub
End Module

Keterangan

TextWriter adalah kelas dasar abstrak dari StreamWriter dan StringWriter, yang masing-masing menulis karakter ke aliran dan string. Gunakan instans TextWriter untuk menulis objek ke string, menulis string ke file, atau untuk menserialisasikan XML. Anda juga dapat menggunakan instans TextWriter untuk menulis teks ke penyimpanan pendukung kustom menggunakan API yang sama dengan yang akan Anda gunakan untuk string atau aliran, atau untuk menambahkan dukungan untuk pemformatan teks.

Write Semua metode TextWriter memiliki jenis data primitif sebagai parameter menuliskan nilai sebagai string.

Secara default, TextWriter utas tidak aman. Lihat TextWriter.Synchronized untuk pembungkus aman utas.

Penting

Jenis ini mengimplementasikan IDisposable antarmuka. Ketika Anda telah selesai menggunakan jenis apa pun yang berasal dari jenis ini, Anda harus membuangnya baik secara langsung atau tidak langsung. Untuk membuang jenis secara langsung, panggil metodenya Dispose dalam try/catch blok. Untuk membuangnya secara tidak langsung, gunakan konstruksi bahasa seperti using (dalam C#) atau Using (di Visual Basic). Untuk informasi selengkapnya, lihat Buang dan bagian "Menggunakan Objek yang Mengimplementasikan IDisposable" dalam IDisposable topik antarmuka.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Catatan Bagi Implementer

Kelas turunan harus menerapkan metode secara Write(Char) minimal untuk membuat instans yang berguna dari TextWriter.

Konstruktor

TextWriter()	Menginisialisasi instans baru kelas TextWriter.
TextWriter(IFormatProvider)	Menginisialisasi instans TextWriter baru kelas dengan penyedia format yang ditentukan.

Bidang

CoreNewLine	Menyimpan karakter baris baru yang digunakan untuk ini `TextWriter`.
Null	`TextWriter` Menyediakan penyimpanan tanpa dukungan yang dapat ditulis, tetapi tidak dapat dibaca.

Properti

Encoding	Saat ditimpa di kelas turunan, mengembalikan pengodean karakter tempat output ditulis.
FormatProvider	Mendapatkan objek yang mengontrol pemformatan.
NewLine	Mendapatkan atau mengatur string terminator baris yang digunakan oleh saat ini `TextWriter`.

Metode

Close()	Menutup penulis saat ini dan merilis sumber daya sistem apa pun yang terkait dengan penulis.
CreateBroadcasting(TextWriter[])	Mewakili penulis yang dapat menulis serangkaian karakter berurutan. Kelas ini abstrak.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang TextWriter digunakan oleh objek .
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh TextWriter dan secara opsional merilis sumber daya terkelola.
DisposeAsync()	Secara asinkron merilis semua sumber daya yang TextWriter digunakan oleh objek .
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Flush()	Menghapus semua buffer untuk penulis saat ini dan menyebabkan data yang di-buffer ditulis ke perangkat yang mendasar.
FlushAsync()	Secara asinkron menghapus semua buffer untuk penulis saat ini dan menyebabkan data yang di-buffer ditulis ke perangkat yang mendasar.
FlushAsync(CancellationToken)	Secara asinkron menghapus semua buffer untuk penulis saat ini dan menyebabkan data yang di-buffer ditulis ke perangkat yang mendasar.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
Synchronized(TextWriter)	Membuat pembungkus aman utas di sekitar yang ditentukan `TextWriter`.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Write(Boolean)	Menulis representasi teks dari `Boolean` nilai ke aliran teks.
Write(Char)	Menulis karakter ke aliran teks.
Write(Char[])	Menulis array karakter ke aliran teks.
Write(Char[], Int32, Int32)	Menulis subarray karakter ke aliran teks.
Write(Decimal)	Menulis representasi teks dari nilai desimal ke aliran teks.
Write(Double)	Menulis representasi teks dari nilai floating-point 8-byte ke aliran teks.
Write(Int32)	Menulis representasi teks dari bilangan bulat bertanda 4 byte ke aliran teks.
Write(Int64)	Menulis representasi teks dari bilangan bulat bertanda tangan 8-byte ke aliran teks.
Write(Object)	Menulis representasi teks objek ke aliran teks dengan memanggil metode pada objek tersebut `ToString` .
Write(ReadOnlySpan<Char>)	Menulis rentang karakter ke aliran teks.
Write(Single)	Menulis representasi teks dari nilai floating-point 4-byte ke aliran teks.
Write(String)	Menulis string ke aliran teks.
Write(String, Object)	Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan Format(String, Object) metode .
Write(String, Object, Object)	Menulis string yang diformat ke aliran teks menggunakan semantik yang sama dengan Format(String, Object, Object) metode .
Write(String, Object, Object, Object)	Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan Format(String, Object, Object, Object) metode .
Write(String, Object[])	Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan Format(String, Object[]) metode .
Write(StringBuilder)	Menulis pembangun string ke aliran teks.
Write(UInt32)	Menulis representasi teks dari bilangan bulat yang tidak ditandatangani 4-byte ke aliran teks.
Write(UInt64)	Menulis representasi teks dari bilangan bulat yang tidak ditandatangani 8-byte ke aliran teks.
WriteAsync(Char)	Menulis karakter ke aliran teks secara asinkron.
WriteAsync(Char[])	Menulis array karakter ke aliran teks secara asinkron.
WriteAsync(Char[], Int32, Int32)	Menulis subarray karakter ke aliran teks secara asinkron.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Secara asinkron menulis wilayah memori karakter ke aliran teks.
WriteAsync(String)	Menulis string ke aliran teks secara asinkron.
WriteAsync(StringBuilder, CancellationToken)	Secara asinkron menulis pembangun string ke aliran teks.
WriteLine()	Menulis terminator baris ke aliran teks.
WriteLine(Boolean)	Menulis representasi `Boolean` teks dari nilai ke aliran teks, diikuti dengan terminator baris.
WriteLine(Char)	Menulis karakter ke aliran teks, diikuti dengan terminator baris.
WriteLine(Char[])	Menulis array karakter ke aliran teks, diikuti dengan terminator baris.
WriteLine(Char[], Int32, Int32)	Menulis subarray karakter ke aliran teks, diikuti dengan terminator baris.
WriteLine(Decimal)	Menulis representasi teks dari nilai desimal ke aliran teks, diikuti dengan terminator baris.
WriteLine(Double)	Menulis representasi teks dari nilai floating-point 8-byte ke aliran teks, diikuti dengan terminator baris.
WriteLine(Int32)	Menulis representasi teks bilangan bulat bertanda 4 byte ke aliran teks, diikuti dengan terminator baris.
WriteLine(Int64)	Menulis representasi teks bilangan bulat bertanda 8 byte ke aliran teks, diikuti dengan terminator baris.
WriteLine(Object)	Menulis representasi teks objek ke aliran teks, dengan memanggil metode pada objek tersebut `ToString` , diikuti dengan terminator baris.
WriteLine(ReadOnlySpan<Char>)	Menulis representasi teks dari rentang karakter ke aliran teks, diikuti dengan terminator baris.
WriteLine(Single)	Menulis representasi teks dari nilai floating-point 4-byte ke aliran teks, diikuti dengan terminator baris.
WriteLine(String)	Menulis string ke aliran teks, diikuti dengan terminator baris.
WriteLine(String, Object)	Menulis string yang diformat dan baris baru ke aliran teks, menggunakan semantik yang sama dengan Format(String, Object) metode .
WriteLine(String, Object, Object)	Menulis string yang diformat dan baris baru ke aliran teks, menggunakan semantik yang sama dengan Format(String, Object, Object) metode .
WriteLine(String, Object, Object, Object)	Menulis string yang diformat dan baris baru ke aliran teks, menggunakan semantik yang sama dengan Format(String, Object).
WriteLine(String, Object[])	Menulis string yang diformat dan baris baru ke aliran teks, menggunakan semantik yang sama dengan Format(String, Object).
WriteLine(StringBuilder)	Menulis representasi teks penyusun string ke aliran teks, diikuti dengan terminator baris.
WriteLine(UInt32)	Menulis representasi teks dari bilangan bulat yang tidak ditandatangani 4 byte ke aliran teks, diikuti dengan terminator baris.
WriteLine(UInt64)	Menulis representasi teks dari bilangan bulat yang tidak ditandatangani 8-byte ke aliran teks, diikuti dengan terminator baris.
WriteLineAsync()	Secara asinkron menulis terminator baris ke aliran teks.
WriteLineAsync(Char)	Secara asinkron menulis karakter ke aliran teks, diikuti dengan terminator baris.
WriteLineAsync(Char[])	Secara asinkron menulis array karakter ke aliran teks, diikuti dengan terminator baris.
WriteLineAsync(Char[], Int32, Int32)	Secara asinkron menulis subarray karakter ke aliran teks, diikuti dengan terminator baris.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Secara asinkron menulis representasi teks dari wilayah memori karakter ke aliran teks, diikuti dengan terminator baris.
WriteLineAsync(String)	Secara asinkron menulis string ke aliran teks, diikuti dengan terminator baris.
WriteLineAsync(StringBuilder, CancellationToken)	Secara asinkron menulis representasi teks penyusun string ke aliran teks, diikuti dengan terminator baris.

Implementasi Antarmuka Eksplisit

IDisposable.Dispose()

Untuk deskripsi anggota ini, lihat Dispose().

Metode Ekstensi

ConfigureAwait(IAsyncDisposable, Boolean)

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

Berlaku untuk