TextWriter Sınıf

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kodlar:
mscorlib.dll, System.IO.dll
Bütünleştirilmiş Kodlar:
netstandard.dll, System.Runtime.dll
Bütünleştirilmiş Kod:
System.IO.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
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ı öğ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 nasıl yazıldığını WriteLineAsync(String) 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 StreamWritersoyut temel sınıfıdırStringWriter. Bir dizeye nesne yazmak, bir dosyaya dize yazmak veya XML'yi serileştirmek 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 Parametre olarak ilkel veri türlerine TextWriter sahip olmanın tüm yöntemleri, değerleri dize olarak yazar.

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

Important

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 atabilmek için, bir Disposetry/ bloğunda catch yöntemini ç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 Dispose ve arabirim konusunun "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 Write(Char) kullanışlı bir örneğini TextWriteroluşturmak için yöntemini en az düzeyde uygulaması gerekir.

Oluşturucular

Name Description
TextWriter()

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

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

Alanlar

Name Description
CoreNewLine

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

TextWriter için yazılabilen ancak okunmayan bir yedekleme deposu sağlar.

Özellikler

Name Description
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

Name Description
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[])

içindeki yazarların writersher birine TextWriter sağlanan girişleri yazan bir ö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()

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

tarafından TextWriter kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları 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ı 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 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 bir dize 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[], Int32, Int32)

Metin akışına karakterlerin alt dizisini yazar.
Write(Char[])

Metin akışına bir karakter dizisi 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, o nesnede yöntemini çağırarak metin akışına ToString yazar.
Write(ReadOnlySpan<Char>)

Metin akışına bir karakter aralığı yazar.
Write(Rune)

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

4 baytlık kayan nokta değerinin metin gösterimini metin akışına 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, Object)

Yöntemiyle aynı semantiği Format(String, 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(String, Object[])

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

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

Metin akışına 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[], Int32, Int32)

Metin akışına zaman uyumsuz olarak bir karakter alt dizisi yazar.
WriteAsync(Char[])

Metin akışına zaman uyumsuz olarak bir karakter dizisi yazar.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

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

Sıralı bir karakter serisi yazabilen bir yazıcıyı temsil eder. Bu sınıf soyut.
WriteAsync(String, CancellationToken)

Sıralı bir karakter serisi yazabilen bir yazıcıyı temsil eder. Bu sınıf soyut.
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ı yazar.
WriteLine(Char)

Metin akışına bir karakter 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(Char[])

Metin akışına bir karakter dizisi ve ardından bir satır sonlandırıcı 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 yöntemini çağırarak ToString 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(Rune)

Sıralı bir karakter serisi yazabilen bir yazıcıyı temsil eder. Bu sınıf soyut.
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, 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, 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)

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[])

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

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

Metin akışına bir dize ve ardından bir satır sonlandırıcı 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(CancellationToken)

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

Zaman uyumsuz olarak metin akışına bir karakter 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(Char[])

Zaman uyumsuz olarak metin akışına bir karakter 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(Rune)

Sıralı bir karakter serisi yazabilen bir yazıcıyı temsil eder. Bu sınıf soyut.
WriteLineAsync(String, CancellationToken)

Sıralı bir karakter serisi yazabilen bir yazıcıyı temsil eder. Bu sınıf soyut.
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ı

Name Description
IDisposable.Dispose()

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

Uzantı Metotları

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