TextWriter Sınıf

Tanım

Ardışık bir karakter serisini yazabilmesi için bir yazıcı temsil eder.Represents a writer that can write a sequential series of characters. Bu sınıf soyuttur.This class is abstract.

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

TextWriterSınıf, soyut bir sınıftır.The TextWriter class is an abstract class. Bu nedenle, bu kodu kodunuzda örnekleyemezsiniz.Therefore, you do not instantiate it in your code. StreamWriterSınıfı öğesinden türetilir TextWriter ve bir akışa yazmak için üyelerin uygulamalarını sağlar.The StreamWriter class derives from TextWriter and provides implementations of the members for writing to a stream. Aşağıdaki örnek, yöntemi kullanılarak bir metin dosyasına dize değerlerinden oluşan iki satırın nasıl yazılacağını gösterir WriteLineAsync(String) .The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String) method.

Sağlaması için türetilmiş bir sınıfta Dispose 'i geçersiz kılınOverride Dispose in a derived class to provide

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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 , ve ' ın soyut temel sınıfıdır StreamWriter ve StringWriter sırasıyla akışlara ve dizelere karakter yazar.TextWriter is the abstract base class of StreamWriter and StringWriter, which write characters to streams and strings, respectively. Bir TextWriter dizeye nesne yazmak, bir dosyaya dizeler yazmak veya XML 'yi seri hale getirmek için örneği oluşturun.Create an instance of TextWriter to write an object to a string, write strings to a file, or to serialize XML. Ayrıca bir örneği TextWriter , bir dize veya akış için kullanacağınız API 'leri kullanarak özel bir yedekleme deposuna metin yazmak veya metin biçimlendirme desteği eklemek için kullanabilirsiniz.You can also use an instance of TextWriter to write text to a custom backing store using the same APIs you would use for a string or a stream, or to add support for text formatting.

Write TextWriter Parametre olarak ilkel veri türleri olan tüm yöntemler, değerleri dizeler olarak yazar.All the Write methods of TextWriter having primitive data types as parameters write out the values as strings.

Varsayılan olarak, bir TextWriter iş parçacığı güvenli değildir.By default, a TextWriter is not thread safe. Bkz TextWriter.Synchronized . iş parçacığı güvenli sarmalayıcı için.See TextWriter.Synchronized for a thread-safe wrapper.

Önemli

Bu tür, IDisposable arabirimini uygular.This type implements the IDisposable interface. Bu türden türetilen herhangi bir türü kullanmayı bitirdiğinizde, bunu doğrudan veya dolaylı olarak atabilirsiniz.When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. Türü doğrudan atmak için, Dispose yöntemini bir try / catch blokta çağırın.To dispose of the type directly, call its Dispose method in a try/catch block. Dolaylı olarak atmak için using (C# dilinde) veya (Visual Basic) gibi bir dil yapısı kullanın Using .To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Daha fazla bilgi için, bkz. The Dispose ve "IDisposable uygulayan bir nesne kullanma" bölümü IDisposable .For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Ortak g/ç görevlerinin listesi için bkz. ortak g/ç görevleri.For a list of common I/O tasks, see Common I/O Tasks.

Uygulayanlara Notlar

Türetilmiş bir sınıf, Write(Char) yararlı bir örneğini oluşturmak için yöntemini en az uygulamalıdır TextWriter .A derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

Oluşturucular

TextWriter()

TextWriter sınıfının yeni bir örneğini başlatır.Initializes a new instance of the TextWriter class.

TextWriter(IFormatProvider)

TextWriterBelirtilen biçim sağlayıcısıyla sınıfının yeni bir örneğini başlatır.Initializes a new instance of the TextWriter class with the specified format provider.

Alanlar

CoreNewLine

Bu için kullanılan yeni satır karakterlerini depolar TextWriter .Stores the newline characters used for this TextWriter.

Null

TextWriterÜzerine yazılamayacağını ancak okunmayan bir yedekleme deposu olmadan bir sağlar.Provides a TextWriter with no backing store that can be written to, but not read from.

Özellikler

Encoding

Türetilmiş bir sınıfta geçersiz kılınırsa, çıktının yazıldığı karakter kodlamasını döndürür.When overridden in a derived class, returns the character encoding in which the output is written.

FormatProvider

Biçimlendirmeyi denetleyen bir nesne alır.Gets an object that controls formatting.

NewLine

Geçerli tarafından kullanılan satır Sonlandırıcı dizesini alır veya ayarlar TextWriter .Gets or sets the line terminator string used by the current TextWriter.

Yöntemler

Close()

Geçerli yazıcıyı kapatır ve yazıcı ile ilişkili tüm sistem kaynaklarını yayınlar.Closes the current writer and releases any system resources associated with the writer.

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm bilgileri içeren bir nesne oluşturur.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

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

Nesne tarafından kullanılan tüm kaynakları serbest bırakır TextWriter .Releases all resources used by the TextWriter object.

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.Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

DisposeAsync()

Nesne tarafından kullanılan tüm kaynakları zaman uyumsuz olarak bırakır TextWriter .Asynchronously releases all resources used by the TextWriter object.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

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

Geçerli yazıcı için tüm arabellekleri temizler ve arabelleğe alınan verilerin temeldeki cihaza yazılmasına neden olur.Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

FlushAsync()

Geçerli yazıcı için tüm arabellekleri zaman uyumsuz olarak temizler ve arabelleğe alınan verilerin temeldeki cihaza yazılmasına neden olur.Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

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

Bu örnek için ömür ilkesini denetleyen geçerli ömür hizmeti nesnesini alır.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

TypeGeçerli örneği alır.Gets the Type of the current instance.

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

Bu örnek için ömür ilkesini denetlemek üzere bir ömür hizmeti nesnesi alır.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

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

Geçerli nesnenin basit bir kopyasını oluşturur MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

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

Belirtilen etrafında bir iş parçacığı güvenli sarmalayıcı oluşturur TextWriter .Creates a thread-safe wrapper around the specified TextWriter.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

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

Bir değerin metin temsilini Boolean metin akışına yazar.Writes the text representation of a Boolean value to the text stream.

Write(Char)

Metin akışına bir karakter yazar.Writes a character to the text stream.

Write(Char[])

Metin akışına bir karakter dizisi yazar.Writes a character array to the text stream.

Write(Char[], Int32, Int32)

Metin akışına bir alt karakter dizisi yazar.Writes a subarray of characters to the text stream.

Write(Decimal)

Ondalık değerin metin temsilini metin akışına yazar.Writes the text representation of a decimal value to the text stream.

Write(Double)

8 baytlık kayan nokta değerinin metin temsilini metin akışına yazar.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Int32)

4 baytlık işaretli bir tamsayının metin temsilini metin akışına yazar.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Int64)

8 baytlık işaretli bir tamsayının metin temsilini metin akışına yazar.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Object)

Bir nesnenin metin gösterimini metin akışına yazar ve ToString yöntemi bu nesnede çağırarak.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(ReadOnlySpan<Char>)

Metin akışına bir karakter yayılımı yazar.Writes a character span to the text stream.

Write(Single)

4 baytlık kayan nokta değerinin metin temsilini metin akışına yazar.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String)

Metin akışına bir dize yazar.Writes a string to the text stream.

Write(String, Object)

, Yöntemiyle aynı semantiğini kullanarak, metin akışına biçimli bir dize yazar Format(String, Object) .Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object)

Yöntemi ile aynı semantiğini kullanarak metin akışına biçimli bir dize yazar Format(String, Object, Object) .Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(String, Object, Object, Object)

, Yöntemiyle aynı semantiğini kullanarak, metin akışına biçimli bir dize yazar Format(String, Object, Object, Object) .Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object[])

, Yöntemiyle aynı semantiğini kullanarak, metin akışına biçimli bir dize yazar Format(String, Object[]) .Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(StringBuilder)

Metin akışına bir dize Oluşturucu yazar.Writes a string builder to the text stream.

Write(UInt32)

4 baytlık işaretsiz tamsayının metin temsilini metin akışına yazar.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(UInt64)

8 baytlık işaretsiz tamsayının metin temsilini metin akışına yazar.Writes the text representation of an 8-byte unsigned integer to the text stream.

WriteAsync(Char)

Metin akışına bir karakter zaman uyumsuz olarak yazar.Writes a character to the text stream asynchronously.

WriteAsync(Char[])

Metin akışına bir karakter dizisi zaman uyumsuz olarak yazar.Writes a character array to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32)

Metin akışına bir alt dizi karakteri zaman uyumsuz olarak yazar.Writes a subarray of characters to the text stream asynchronously.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Zaman uyumsuz olarak metin akışına bir karakter bellek bölgesi yazar.Asynchronously writes a character memory region to the text stream.

WriteAsync(String)

Metin akışına dize zaman uyumsuz olarak yazar.Writes a string to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken)

Zaman uyumsuz olarak bir dize oluşturucuyu metin akışına yazar.Asynchronously writes a string builder to the text stream.

WriteLine()

Metin akışına bir satır Sonlandırıcı yazar.Writes a line terminator to the text stream.

WriteLine(Boolean)

Bir değerin metin gösterimini Boolean metin akışına yazar ve ardından bir satır Sonlandırıcı izler.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine(Char)

Metin akışına bir karakter yazar ve ardından satır Sonlandırıcı izler.Writes a character to the text stream, followed by a line terminator.

WriteLine(Char[])

Metin akışına bir karakter dizisi yazar ve ardından bir satır Sonlandırıcı izler.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char[], Int32, Int32)

Metin akışına, ardından bir satır Sonlandırıcı tarafından bir alt dizi karakter yazar.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(Decimal)

Ondalık değerin metin gösterimini metin akışına yazar ve ardından bir satır Sonlandırıcı izler.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Double)

8 baytlık kayan nokta değerinin metin temsilini metin akışına yazar ve ardından bir satır Sonlandırıcı izler.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Int32)

4 baytlık işaretli bir tamsayının metin gösterimini metin akışına yazar ve ardından bir satır Sonlandırıcı izler.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int64)

8 baytlık işaretli bir tamsayının metin temsilini metin akışına yazar ve ardından bir satır Sonlandırıcı izler.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Object)

Bir nesnenin metin gösterimini metin akışına yazar, ToString Bu nesne üzerinde yöntemi çağırarak ve ardından bir satır Sonlandırıcı gelir.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

WriteLine(ReadOnlySpan<Char>)

Bir karakter yayılımının metin temsilini metin akışına yazar ve ardından bir satır Sonlandırıcı izler.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(Single)

4 baytlık kayan nokta değerinin metin temsilini metin akışına yazar ve ardından bir satır Sonlandırıcı izler.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(String)

Metin akışına bir dize yazar ve ardından bir satır Sonlandırıcı izler.Writes a string to the text stream, followed by a line terminator.

WriteLine(String, Object)

, Yöntemiyle aynı semantiğini kullanarak, metin akışına biçimli bir dize ve yeni bir satır yazar Format(String, Object) .Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object) method.

WriteLine(String, Object, Object)

, Yöntemiyle aynı semantiğini kullanarak, metin akışına biçimli bir dize ve yeni bir satır yazar Format(String, Object, Object) .Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object, Object) method.

WriteLine(String, Object, Object, Object)

Metin akışına, ile aynı semantiğini kullanarak, biçimlendirilen bir dizeyi ve yeni bir satırı yazar Format(String, Object) .Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(String, Object[])

Metin akışına, ile aynı semantiğini kullanarak, biçimlendirilen bir dizeyi ve yeni bir satırı yazar Format(String, Object) .Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(StringBuilder)

Bir dize oluşturucusunun metin gösterimini metin akışına yazar ve ardından bir satır Sonlandırıcı izler.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(UInt32)

4 baytlık işaretsiz tamsayının metin temsilini metin akışına yazar ve ardından bir satır Sonlandırıcı izler.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt64)

Bir 8 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar ve ardından bir satır Sonlandırıcı izler.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLineAsync()

Zaman uyumsuz olarak metin akışına bir satır Sonlandırıcı yazar.Asynchronously writes a line terminator to the text stream.

WriteLineAsync(Char)

Zaman uyumsuz olarak metin akışına bir karakter yazar ve ardından satır Sonlandırıcı gelir.Asynchronously writes a character to the text stream, followed by a line terminator.

WriteLineAsync(Char[])

Zaman uyumsuz bir karakter dizisini metin akışına, ardından bir satır Sonlandırıcı ile yazar.Asynchronously writes an array of characters to the text stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32)

Zaman uyumsuz olarak bir alt dizi karakteri metin akışına yazar ve ardından bir satır Sonlandırıcı gelir.Asynchronously writes a subarray of characters to the text stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Bir karakter belleği bölgesinin metin gösterimini zaman uyumsuz olarak metin akışına yazar ve ardından bir satır Sonlandırıcı gelir.Asynchronously writes the text representation of a character memory region to the text stream, followed by a line terminator.

WriteLineAsync(String)

Zaman uyumsuz olarak metin akışına bir dize yazar ve ardından satır Sonlandırıcı gelir.Asynchronously writes a string to the text stream, followed by a line terminator.

WriteLineAsync(StringBuilder, CancellationToken)

Zaman uyumsuz olarak bir dize oluşturucusunun metin temsilini metin akışına yazar ve ardından bir satır Sonlandırıcı gelir.Asynchronously writes the text representation of a string builder to the text stream, followed by a line terminator.

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

Bu üyenin açıklaması için bkz Dispose() ..For a description of this member, see Dispose().

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir döndürülen görevlerin ne kadar beklediğini yapılandırır.Configures how awaits on the tasks returned from an async disposable are performed.

Şunlara uygulanır

Ayrıca bkz.