TextWriter Sınıf

Tanım

Sıralı karakter serisi yazabilen bir yazıcıyı temsil eder. Bu sınıf soyut.

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
Devralma
TextWriter
Devralma
Türetilmiş
Öznitelikler
Uygulamalar

Örnekler

TextWriter sınıfı soyut bir sınıftır. Bu nedenle, kodunuzda örneği oluşturmazsınız. StreamWriter sınıfı, öğesinden TextWriter türetilir ve bir akışa yazmak için üyelerin uygulamalarını sağlar. Aşağıdaki örnek, yöntemini kullanarak bir metin dosyasına dize değerlerinden oluşan iki satırın WriteLineAsync(String) nasıl yazıldığını gösterir.

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

Açıklamalar

TextWriter, akışlara ve dizelere sırasıyla karakter yazan ve StringWritersoyut temel sınıfıdırStreamWriter. Bir dizeye nesne yazmak, dosyaya dize yazmak veya XML'yi seri hale getirmek için örneğini TextWriter kullanın. örneğini TextWriter , bir dize veya akış için kullandığınız API'leri kullanarak özel bir yedekleme deposuna metin yazmak veya metin biçimlendirme desteği eklemek için de kullanabilirsiniz.

Write Parametreler olarak temel veri türlerine TextWriter sahip olmanın tüm yöntemleri, değerleri dize olarak yazar.

Varsayılan olarak, bir TextWriter iş parçacığı güvenli değildir. İş parçacığı güvenli sarmalayıcı için bkz TextWriter.Synchronized .

Önemli

Bu tür arabirimini IDisposable uygular. Bu türden türetilen herhangi bir türü kullanmayı bitirdiğinizde, doğrudan veya dolaylı olarak atmalısınız. Türü doğrudan atmak için yöntemini bir try/catch blokta çağırın.Dispose Bunu dolaylı olarak atmak için (C#'ta) veya Using (Visual Basic'te) gibi using bir dil yapısı kullanın. Daha fazla bilgi için dispose ve arabirim konusunda "IDisposable Uygulayan Bir Nesne Kullanma" bölümüne IDisposable bakın.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Uygulayanlara Notlar

Türetilmiş bir sınıfın kullanışlı bir örneğini Write(Char)TextWriteroluşturmak için yöntemini en az düzeyde uygulaması gerekir.

Oluşturucular

TextWriter()

TextWriter sınıfının yeni bir örneğini başlatır.

TextWriter(IFormatProvider)

Belirtilen biçim sağlayıcısıyla sınıfının yeni bir örneğini TextWriter başlatır.

Alanlar

CoreNewLine

Bu TextWriteriçin kullanılan yeni satır karakterlerini depolar.

Null

Yazılabilen ancak okunmayan yedekleme deposu olmayan bir TextWriter sağlar.

Özellikler

Encoding

Türetilmiş bir sınıfta geçersiz kılındığında, çıkışın yazıldığı karakter kodlamasını döndürür.

FormatProvider

Biçimlendirmeyi denetleen bir nesne alır.

NewLine

Geçerli TextWritertarafından kullanılan satır sonlandırıcı dizesini alır veya ayarlar.

Yöntemler

Close()

Geçerli yazıcıyı kapatır ve yazıcıyla ilişkili tüm sistem kaynaklarını serbest bırakır.

CreateBroadcasting(TextWriter[])

Sıralı karakter serisi yazabilen bir yazıcıyı temsil eder. Bu sınıf soyut.

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

(Devralındığı yer: MarshalByRefObject)
Dispose()

nesnesi tarafından TextWriter kullanılan tüm kaynakları serbest bırakır.

Dispose(Boolean)

TextWriter tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

DisposeAsync()

Nesne tarafından TextWriter kullanılan tüm kaynakları zaman uyumsuz olarak serbest bırakır.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
Flush()

Geçerli yazıcının tüm arabelleklerini temizler ve arabelleğe alınan verilerin temel alınan cihaza yazılmasına neden olur.

FlushAsync()

Geçerli yazıcı için tüm arabellekleri zaman uyumsuz olarak temizler ve arabelleğe alınan verilerin temel alınan cihaza yazılmasına neden olur.

FlushAsync(CancellationToken)

Geçerli yazıcı için tüm arabellekleri zaman uyumsuz olarak temizler ve arabelleğe alınan verilerin temel alınan cihaza yazılmasına neden olur.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

(Devralındığı yer: MarshalByRefObject)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
Synchronized(TextWriter)

Belirtilen TextWriterçevresinde iş parçacığı güvenli bir sarmalayıcı oluşturur.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
Write(Boolean)

Bir Boolean değerin metin gösterimini metin akışına yazar.

Write(Char)

Metin akışına bir karakter yazar.

Write(Char[])

Metin akışına bir karakter dizisi yazar.

Write(Char[], Int32, Int32)

Metin akışına karakterlerin alt dizisini yazar.

Write(Decimal)

Ondalık değerin metin gösterimini metin akışına yazar.

Write(Double)

8 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar.

Write(Int32)

4 baytlık imzalı tamsayının metin gösterimini metin akışına yazar.

Write(Int64)

8 baytlık imzalı tamsayının metin gösterimini metin akışına yazar.

Write(Object)

Bir nesnenin metin gösterimini, bu nesnede yöntemini çağırarak metin akışına ToString yazar.

Write(ReadOnlySpan<Char>)

Metin akışına bir karakter aralığı yazar.

Write(Single)

4 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar.

Write(String)

Metin akışına bir dize yazar.

Write(String, Object)

Yöntemiyle aynı semantiği Format(String, Object) kullanarak metin akışına biçimlendirilmiş bir dize yazar.

Write(String, Object, Object)

Yöntemiyle aynı semantiği Format(String, Object, Object) kullanarak metin akışına biçimlendirilmiş bir dize yazar.

Write(String, Object, Object, Object)

Yöntemiyle aynı semantiği Format(String, Object, Object, Object) kullanarak metin akışına biçimlendirilmiş bir dize yazar.

Write(String, Object[])

Yöntemiyle aynı semantiği Format(String, Object[]) kullanarak metin akışına biçimlendirilmiş bir dize yazar.

Write(StringBuilder)

Metin akışına bir dize oluşturucu yazar.

Write(UInt32)

4 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar.

Write(UInt64)

8 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar.

WriteAsync(Char)

Metin akışına zaman uyumsuz olarak bir karakter yazar.

WriteAsync(Char[])

Metin akışına zaman uyumsuz olarak bir karakter dizisi yazar.

WriteAsync(Char[], Int32, Int32)

Metin akışına zaman uyumsuz olarak bir karakter alt dizisi yazar.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Metin akışına zaman uyumsuz olarak bir karakter bellek bölgesi yazar.

WriteAsync(String)

Metin akışına zaman uyumsuz olarak bir dize yazar.

WriteAsync(StringBuilder, CancellationToken)

Zaman uyumsuz olarak metin akışına bir dize oluşturucu yazar.

WriteLine()

Metin akışına bir satır sonlandırıcı yazar.

WriteLine(Boolean)

Bir Boolean değerin metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler.

WriteLine(Char)

Metin akışına bir karakter ve ardından bir satır sonlandırıcı yazar.

WriteLine(Char[])

Metin akışına bir karakter dizisi ve ardından bir satır sonlandırıcı yazar.

WriteLine(Char[], Int32, Int32)

Metin akışına karakterlerin bir alt dizisini ve ardından bir satır sonlandırıcısını yazar.

WriteLine(Decimal)

Ondalık değerin metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler.

WriteLine(Double)

8 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar ve ardından bir çizgi sonlandırıcısı ekler.

WriteLine(Int32)

Metin akışına 4 baytlık imzalı bir tamsayının metin gösterimini ve ardından bir satır sonlandırıcısını yazar.

WriteLine(Int64)

Metin akışına 8 baytlık imzalı tamsayının metin gösterimini ve ardından bir satır sonlandırıcısını yazar.

WriteLine(Object)

Bir nesnenin metin gösterimini, bu nesnede yöntemini çağırarak metin akışına ToString yazar ve ardından bir satır sonlandırıcısı ekler.

WriteLine(ReadOnlySpan<Char>)

Bir karakter aralığının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler.

WriteLine(Single)

Metin akışına 4 baytlık kayan nokta değerinin metin gösterimini ve ardından bir çizgi sonlandırıcısını yazar.

WriteLine(String)

Metin akışına bir dize ve ardından bir satır sonlandırıcı yazar.

WriteLine(String, Object)

Yöntemiyle aynı semantiği Format(String, Object) kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar.

WriteLine(String, Object, Object)

Yöntemiyle aynı semantiği Format(String, Object, Object) kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar.

WriteLine(String, Object, Object, Object)

ile aynı semantiği Format(String, Object)kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar.

WriteLine(String, Object[])

ile aynı semantiği Format(String, Object)kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar.

WriteLine(StringBuilder)

Bir dize oluşturucusunun metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler.

WriteLine(UInt32)

4 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler.

WriteLine(UInt64)

8 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler.

WriteLineAsync()

Zaman uyumsuz olarak metin akışına bir satır sonlandırıcı yazar.

WriteLineAsync(Char)

Zaman uyumsuz olarak metin akışına bir karakter ve ardından bir satır sonlandırıcı yazar.

WriteLineAsync(Char[])

Zaman uyumsuz olarak metin akışına bir karakter dizisi ve ardından bir satır sonlandırıcı yazar.

WriteLineAsync(Char[], Int32, Int32)

Zaman uyumsuz olarak metin akışına karakterlerin alt dizisini ve ardından bir satır sonlandırıcı yazar.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Bir karakter bellek bölgesinin metin gösterimini zaman uyumsuz olarak metin akışına yazar ve ardından bir satır sonlandırıcısı ekler.

WriteLineAsync(String)

Zaman uyumsuz olarak metin akışına bir dize ve ardından bir satır sonlandırıcı yazar.

WriteLineAsync(StringBuilder, CancellationToken)

Bir dize oluşturucusunun metin gösterimini zaman uyumsuz olarak metin akışına ve ardından bir satır sonlandırıcısına yazar.

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

Bu üyenin açıklaması için bkz Dispose(). .

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirildiğini yapılandırılır.

Şunlara uygulanır

Ayrıca bkz.