TextWriter Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kod:
System.IO.dll
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
System.Runtime.Extensions.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
TextWriter.cs
Kaynak:
TextWriter.cs
Kaynak:
TextWriter.cs

Sıralı bir 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
Object
TextWriter
Devralma
Object
MarshalByRefObject
TextWriter
Türetilmiş
Öznitelikler
SerializableAttribute ComVisibleAttribute
Uygulamalar
IDisposable IAsyncDisposable

Örnekler

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

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, sırasıyla akışlara ve dizelere karakter yazan StreamWriter ve StringWritersoyut temel sınıfıdır. Bir dizeye nesne yazmak, dosyaya dize yazmak veya XML'yi serileştirmek için TextWriter örneğini kullanın. TextWriter örneğini, 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.

İlkel veri türlerini parametre olarak TextWriter tüm Write yöntemleri değerleri dize olarak yazar.

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

Önemli

Bu tür IDisposable arabirimini 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 Dispose yöntemini bir try/catch bloğunda çağırın. Bunu dolaylı olarak atmak için using (C#'de) veya Using (Visual Basic'te) gibi bir dil yapısı kullanın. Daha fazla bilgi için, IDisposable arabirimi konusunun Dispose ve "IDisposable Uygulayan Bir Nesne Kullanma" bölümüne bakın.

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

Uygulayanlara Notlar

Türetilmiş bir sınıf, TextWriterkullanışlı bir örneğini oluşturmak için en az Write(Char) yöntemini uygulamalıdır.

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 TextWriter sınıfının yeni bir örneğini başlatır.

Alanlar

CoreNewLine

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

Yazılabilen ancak okunmayan bir 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[])

writers'daki yazıcıların her birine sağlanan girişleri yazan bir TextWriter örneği oluşturur.
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()

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

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

TextWriter nesnesi tarafından 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ı için tüm arabellekleri 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()

Geçerli örneğin Type 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 Objectbasit bir kopyasını oluşturur.

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

Geçerli MarshalByRefObject nesnesinin 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 bir dize döndürür.

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

Bir Boolean değerinin 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)

Nesne üzerinde ToString yöntemini çağırarak bir nesnenin metin gösterimini metin akışına 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)

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

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

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

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

Format(String, ReadOnlySpan<Object>)ile aynı semantiği 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ğerinin metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar.
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 yazar ve ardından bir satır sonlandırıcısı yazar.
WriteLine(Decimal)

Bir ondalık değerin metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar.
WriteLine(Double)

Metin akışına 8 baytlık kayan nokta değerinin metin gösterimini ve ardından bir satır sonlandırıcı yazar.
WriteLine(Int32)

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

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

Bir nesnenin metin gösterimini, bu nesnede ToString yöntemini çağırarak ve ardından bir satır sonlandırıcısı çağırarak metin akışına yazar.
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ı yazar.
WriteLine(Single)

Metin akışına 4 baytlık kayan nokta değerinin metin gösterimini ve ardından bir satır sonlandırıcı yazar.
WriteLine(String)

Metin akışına bir dize ve ardından bir satır sonlandırıcı yazar.
WriteLine(String, Object)

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

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

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

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

Format(String, ReadOnlySpan<Object>)ile aynı semantiği 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ı yazar.
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ı yazar.
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ı yazar.
WriteLineAsync()

Zaman uyumsuz olarak metin akışına bir satır sonlandırıcı yazar.
WriteLineAsync(Char)

Zaman uyumsuz olarak metin akışına bir karakter yazar ve ardından bir satır sonlandırıcısı yazar.
WriteLineAsync(Char[])

Zaman uyumsuz olarak metin akışına bir karakter dizisi yazar ve ardından bir satır sonlandırıcısı yazar.
WriteLineAsync(Char[], Int32, Int32)

Zaman uyumsuz olarak metin akışına bir karakter alt dizisi yazar ve ardından bir satır sonlandırıcısı 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ı yazar.
WriteLineAsync(String)

Zaman uyumsuz olarak metin akışına bir dize yazar ve ardından bir satır sonlandırıcısı yazar.
WriteLineAsync(StringBuilder, CancellationToken)

Bir dize oluşturucusunun metin gösterimini zaman uyumsuz olarak metin akışına yazar ve ardından bir satır sonlandırıcısı 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ştirileceğini yapılandırılır.

Şunlara uygulanır

Ayrıca bkz.