TextWriter Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

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 : MarshalByRefObject, IAsyncDisposable, IDisposable

public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable

type TextWriter = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Devralma

Object

MarshalByRefObject

TextWriter

Türetilmiş

System.CodeDom.Compiler.IndentedTextWriter

System.IO.StreamWriter

System.IO.StringWriter

System.Web.HttpWriter

System.Web.UI.HtmlTextWriter

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

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.

Ayrıca bkz.

• StreamWriter
• StringWriter
• Dosya ve Akış G/Ç
• Nasıl yapılır: Dosya Metin Okuma
• Nasıl yapılır: Dosya Metin Yazma
• Nasıl yapılır: Yeni Oluşturulan Veri Dosyası Okuma ve Yazma