Bagikan melalui

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

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
Atribut
SerializableAttribute ComVisibleAttribute
Penerapan
IDisposable IAsyncDisposable

Contoh

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

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 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.

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

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

Penting

Jenis ini mengimplementasikan antarmuka IDisposable. 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 metode Dispose dalam blok try/catch. Untuk membuangnya secara tidak langsung, gunakan konstruksi bahasa seperti using (dalam C#) atau Using (di Visual Basic). Untuk informasi selengkapnya, lihat bagian Buang dan bagian "Menggunakan Objek yang Mengimplementasikan IDisposable" di topik antarmuka IDisposable.

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

Catatan Bagi Implementer

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

Konstruktor

TextWriter()

Menginisialisasi instans baru kelas TextWriter.
TextWriter(IFormatProvider)

Menginisialisasi instans baru kelas TextWriter dengan penyedia format yang ditentukan.

Bidang

CoreNewLine

Menyimpan karakter baris baru yang digunakan untuk TextWriterini.
Null

Menyediakan TextWriter tanpa penyimpanan backing yang dapat ditulis, tetapi tidak dibaca dari.

Properti

Encoding

Saat ditimpa dalam kelas turunan, mengembalikan pengodean karakter tempat output ditulis.
FormatProvider

Mendapatkan objek yang mengontrol pemformatan.
NewLine

Mendapatkan atau mengatur string terminator baris yang digunakan oleh TextWritersaat ini.

Metode

Close()

Menutup penulis saat ini dan merilis sumber daya sistem apa pun yang terkait dengan penulis.
CreateBroadcasting(TextWriter[])

Membuat instans TextWriter yang menulis input yang disediakan ke setiap penulis di writers.
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 digunakan oleh objek TextWriter.
Dispose(Boolean)

Merilis sumber daya yang tidak dikelola yang digunakan oleh TextWriter dan secara opsional merilis sumber daya terkelola.
DisposeAsync()

Secara asinkron merilis semua sumber daya yang digunakan oleh objek TextWriter.
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 buffer ditulis ke perangkat yang mendasar.
FlushAsync()

Secara asinkron menghapus semua buffer untuk penulis saat ini dan menyebabkan data buffer ditulis ke perangkat yang mendasar.
FlushAsync(CancellationToken)

Secara asinkron menghapus semua buffer untuk penulis saat ini dan menyebabkan data 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 Type instans 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 Objectsaat ini.

(Diperoleh dari Object)
MemberwiseClone(Boolean)

Membuat salinan dangkal objek MarshalByRefObject saat ini.

(Diperoleh dari MarshalByRefObject)
Synchronized(TextWriter)

Membuat pembungkus aman utas di sekitar TextWriteryang ditentukan .
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)
Write(Boolean)

Menulis representasi teks dari nilai Boolean 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 tangan 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 ToString pada objek tersebut.
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 metode Format(String, Object).
Write(String, Object, Object)

Menulis string yang diformat ke aliran teks menggunakan semantik yang sama dengan metode Format(String, Object, Object).
Write(String, Object, Object, Object)

Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan metode Format(String, Object, Object, Object).
Write(String, Object[])

Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan metode Format(String, Object[]).
Write(String, ReadOnlySpan<Object>)

Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan Format(String, ReadOnlySpan<Object>).
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)

Menulis wilayah memori karakter secara asinkron ke aliran teks.
WriteAsync(String)

Menulis string ke aliran teks secara asinkron.
WriteAsync(StringBuilder, CancellationToken)

Menulis pembangun string secara asinkron ke aliran teks.
WriteLine()

Menulis terminator baris ke aliran teks.
WriteLine(Boolean)

Menulis representasi teks dari nilai Boolean ke aliran teks, diikuti oleh terminator baris.
WriteLine(Char)

Menulis karakter ke aliran teks, diikuti oleh terminator baris.
WriteLine(Char[])

Menulis array karakter ke aliran teks, diikuti oleh terminator baris.
WriteLine(Char[], Int32, Int32)

Menulis subarray karakter ke aliran teks, diikuti oleh terminator baris.
WriteLine(Decimal)

Menulis representasi teks dari nilai desimal ke aliran teks, diikuti oleh terminator baris.
WriteLine(Double)

Menulis representasi teks dari nilai floating-point 8-byte ke aliran teks, diikuti oleh terminator baris.
WriteLine(Int32)

Menulis representasi teks bilangan bulat bertanda tangan 4-byte ke aliran teks, diikuti oleh terminator baris.
WriteLine(Int64)

Menulis representasi teks bilangan bulat bertanda tangan 8-byte ke aliran teks, diikuti oleh terminator baris.
WriteLine(Object)

Menulis representasi teks objek ke aliran teks, dengan memanggil metode ToString pada objek tersebut, diikuti oleh terminator baris.
WriteLine(ReadOnlySpan<Char>)

Menulis representasi teks dari rentang karakter ke aliran teks, diikuti oleh terminator baris.
WriteLine(Single)

Menulis representasi teks dari nilai floating-point 4-byte ke aliran teks, diikuti oleh terminator baris.
WriteLine(String)

Menulis string ke aliran teks, diikuti oleh terminator baris.
WriteLine(String, Object)

Menulis string yang diformat dan baris baru ke aliran teks, menggunakan semantik yang sama dengan metode Format(String, Object).
WriteLine(String, Object, Object)

Menulis string yang diformat dan baris baru ke aliran teks, menggunakan semantik yang sama dengan metode Format(String, Object, Object).
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(String, ReadOnlySpan<Object>)

Menulis string yang diformat dan baris baru ke aliran teks, menggunakan semantik yang sama dengan Format(String, ReadOnlySpan<Object>).
WriteLine(StringBuilder)

Menulis representasi teks penyusun string ke aliran teks, diikuti oleh terminator baris.
WriteLine(UInt32)

Menulis representasi teks dari bilangan bulat yang tidak ditandatangani 4 byte ke aliran teks, diikuti oleh terminator baris.
WriteLine(UInt64)

Menulis representasi teks dari bilangan bulat yang tidak ditandatangani 8 byte ke aliran teks, diikuti oleh terminator baris.
WriteLineAsync()

Menulis terminator baris secara asinkron ke aliran teks.
WriteLineAsync(Char)

Secara asinkron menulis karakter ke aliran teks, diikuti oleh terminator garis.
WriteLineAsync(Char[])

Secara asinkron menulis array karakter ke aliran teks, diikuti oleh terminator baris.
WriteLineAsync(Char[], Int32, Int32)

Secara asinkron menulis subarray karakter ke aliran teks, diikuti oleh terminator baris.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Secara asinkron menulis representasi teks wilayah memori karakter ke aliran teks, diikuti oleh terminator baris.
WriteLineAsync(String)

Secara asinkron menulis string ke aliran teks, diikuti oleh terminator baris.
WriteLineAsync(StringBuilder, CancellationToken)

Secara asinkron menulis representasi teks pembangun string ke aliran teks, diikuti oleh 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 akan dilakukan.

Berlaku untuk

Lihat juga