TextWriter Klasa

Definicja

Reprezentuje moduł zapisujący, który może napisać sekwencyjną serię znaków. Ta klasa jest abstrakcyjna.

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
Dziedziczenie
TextWriter
Dziedziczenie
Pochodne
Atrybuty
Implementuje

Przykłady

Klasa TextWriter jest abstrakcyjną klasą. W związku z tym, nie tworzy się obiektu w kodzie. Klasa StreamWriter pochodzi z TextWriter klasy i udostępnia implementacje składowych do zapisu w strumieniu. W poniższym przykładzie pokazano, jak napisać dwa wiersze składające się z wartości ciągu do pliku tekstowego przy użyciu WriteLineAsync(String) metody .

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

Uwagi

TextWriter jest abstrakcyjną klasą bazową i StreamWriter StringWriter, która zapisuje znaki w strumieniach i ciągach, odpowiednio. Utwórz wystąpienie TextWriter klasy , aby zapisać obiekt w ciągu, zapisać ciągi w pliku lub serializować kod XML. Możesz również użyć wystąpienia TextWriter klasy , aby zapisać tekst w niestandardowym magazynie pomocniczym przy użyciu tych samych interfejsów API, których można użyć dla ciągu lub strumienia, albo dodać obsługę formatowania tekstu.

Write Wszystkie metody posiadania pierwotnych TextWriter typów danych jako parametry zapisują wartości jako ciągi.

Domyślnie element TextWriter nie jest bezpieczny wątkiem. Zobacz TextWriter.Synchronized , aby zapoznać się z otoką bezpieczną wątkowo.

Ważne

Ten typ implementuje IDisposable interfejs. Po zakończeniu korzystania z dowolnego typu pochodzącego z tego typu należy usunąć go bezpośrednio lub pośrednio. Aby bezpośrednio usunąć typ, wywołaj jego Dispose metodę try/catch w bloku. Aby usunąć go pośrednio, należy użyć konstrukcji językowej, takiej jak using (w języku C#) lub Using (w Visual Basic). Aby uzyskać więcej informacji, zobacz sekcję Dispose i "Using an Object that Implements IDisposable" w temacie interfejsu IDisposable .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Uwagi dotyczące implementowania

Klasa pochodna musi minimalnie zaimplementować metodę Write(Char) , aby utworzyć przydatne wystąpienie TextWriterklasy .

Konstruktory

TextWriter()

Inicjuje nowe wystąpienie klasy TextWriter.

TextWriter(IFormatProvider)

Inicjuje TextWriter nowe wystąpienie klasy przy użyciu określonego dostawcy formatu.

Pola

CoreNewLine

Przechowuje znaki nowego wiersza używane dla tego TextWriterelementu .

Null

Zapewnia magazyn TextWriter zapasowy bez magazynu zapasowego, do którego można zapisywać dane, ale nie jest odczytywany.

Właściwości

Encoding

Gdy przesłonięć w klasie pochodnej, zwraca kodowanie znaków, w którym dane wyjściowe są zapisywane.

FormatProvider

Pobiera obiekt, który kontroluje formatowanie.

NewLine

Pobiera lub ustawia ciąg terminatora wiersza używany przez bieżący TextWriterelement .

Metody

Close()

Zamyka bieżący moduł zapisywania i zwalnia wszystkie zasoby systemowe skojarzone z modułem zapisywania.

CreateObjRef(Type)

Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez TextWriter obiekt .

Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element TextWriter i opcjonalnie zwalnia zasoby zarządzane.

DisposeAsync()

Asynchronicznie zwalnia wszystkie zasoby używane przez TextWriter obiekt .

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
Flush()

Czyści wszystkie bufory dla bieżącego składnika zapisywania i powoduje zapisanie wszystkich buforowanych danych na urządzeniu źródłowym.

FlushAsync()

Asynchronicznie czyści wszystkie bufory dla bieżącego składnika zapisywania i powoduje zapisanie wszystkich buforowanych danych na urządzeniu bazowym.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu.

(Odziedziczone po MarshalByRefObject)
Synchronized(TextWriter)

Tworzy bezpieczną wątkowo otokę wokół określonego TextWriterelementu .

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
Write(Boolean)

Zapisuje tekstową reprezentację Boolean wartości w strumieniu tekstowym.

Write(Char)

Zapisuje znak do strumienia tekstu.

Write(Char[])

Zapisuje tablicę znaków do strumienia tekstu.

Write(Char[], Int32, Int32)

Zapisuje podarraj znaków do strumienia tekstu.

Write(Decimal)

Zapisuje reprezentację tekstową wartości dziesiętnej w strumieniu tekstowym.

Write(Double)

Zapisuje tekstową reprezentację 8-bajtowej wartości zmiennoprzecinkowej do strumienia tekstu.

Write(Int32)

Zapisuje reprezentację tekstową 4-bajtowej liczby całkowitej ze znakiem do strumienia tekstu.

Write(Int64)

Zapisuje tekstową reprezentację 8-bajtowej liczby całkowitej ze znakiem do strumienia tekstu.

Write(Object)

Zapisuje reprezentację tekstu obiektu w strumieniu tekstowym przez wywołanie ToString metody na tym obiekcie.

Write(ReadOnlySpan<Char>)

Zapisuje zakres znaków do strumienia tekstu.

Write(Single)

Zapisuje tekstową reprezentację wartości zmiennoprzecinkowej 4-bajtowej na strumień tekstowy.

Write(String)

Zapisuje ciąg w strumieniu tekstowym.

Write(String, Object)

Zapisuje sformatowany ciąg do strumienia tekstu przy użyciu tych samych semantyki co Format(String, Object) metoda.

Write(String, Object, Object)

Zapisuje sformatowany ciąg do strumienia tekstu przy użyciu tych samych semantyki co Format(String, Object, Object) metoda.

Write(String, Object, Object, Object)

Zapisuje sformatowany ciąg do strumienia tekstu przy użyciu tych samych semantyki co Format(String, Object, Object, Object) metoda.

Write(String, Object[])

Zapisuje sformatowany ciąg do strumienia tekstu przy użyciu tych samych semantyki co Format(String, Object[]) metoda.

Write(StringBuilder)

Zapisuje konstruktora ciągów do strumienia tekstu.

Write(UInt32)

Zapisuje reprezentację tekstową 4-bajtowej liczby całkowitej bez znaku do strumienia tekstu.

Write(UInt64)

Zapisuje reprezentację tekstową 8-bajtowej liczby całkowitej bez znaku do strumienia tekstu.

WriteAsync(Char)

Zapisuje znak do strumienia tekstu asynchronicznie.

WriteAsync(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym asynchronicznie.

WriteAsync(Char[], Int32, Int32)

Zapisuje podarraj znaków do strumienia tekstu asynchronicznie.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie zapisuje region pamięci znaków w strumieniu tekstowym.

WriteAsync(String)

Zapisuje ciąg w strumieniu tekstowym asynchronicznie.

WriteAsync(StringBuilder, CancellationToken)

Asynchronicznie zapisuje konstruktora ciągów do strumienia tekstu.

WriteLine()

Zapisuje terminator wiersza do strumienia tekstu.

WriteLine(Boolean)

Zapisuje tekstową reprezentację Boolean wartości w strumieniu tekstowym, a następnie terminator wiersza.

WriteLine(Char)

Zapisuje znak do strumienia tekstu, po którym następuje terminator wiersza.

WriteLine(Char[])

Zapisuje tablicę znaków do strumienia tekstu, a następnie terminator wiersza.

WriteLine(Char[], Int32, Int32)

Zapisuje podarraj znaków do strumienia tekstu, po którym następuje terminator wiersza.

WriteLine(Decimal)

Zapisuje tekstową reprezentację wartości dziesiętnej do strumienia tekstowego, a następnie terminator wiersza.

WriteLine(Double)

Zapisuje tekstową reprezentację wartości zmiennoprzecinkowej 8 bajtów na strumień tekstowy, a następnie terminator wiersza.

WriteLine(Int32)

Zapisuje reprezentację tekstową 4-bajtowej liczby całkowitej ze znakiem do strumienia tekstowego, po której następuje terminator wiersza.

WriteLine(Int64)

Zapisuje tekstową reprezentację liczby całkowitej ze znakiem 8 bajtów do strumienia tekstu, a następnie terminator wiersza.

WriteLine(Object)

Zapisuje reprezentację tekstową obiektu w strumieniu tekstowym, wywołując ToString metodę w tym obiekcie, a następnie terminator wiersza.

WriteLine(ReadOnlySpan<Char>)

Zapisuje reprezentację tekstu zakresu znaków w strumieniu tekstowym, po którym następuje terminator wiersza.

WriteLine(Single)

Zapisuje reprezentację tekstową 4-bajtowej wartości zmiennoprzecinkowej do strumienia tekstowego, a następnie terminator linii.

WriteLine(String)

Zapisuje ciąg w strumieniu tekstowym, po którym następuje terminator wiersza.

WriteLine(String, Object)

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tej samej semantyki co Format(String, Object) metoda.

WriteLine(String, Object, Object)

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tych samych semantyki co Format(String, Object, Object) metoda.

WriteLine(String, Object, Object, Object)

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tych samych semantyki co Format(String, Object).

WriteLine(String, Object[])

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tych samych semantyki co Format(String, Object).

WriteLine(StringBuilder)

Zapisuje tekstową reprezentację konstruktora ciągów w strumieniu tekstowym, po którym następuje terminator wiersza.

WriteLine(UInt32)

Zapisuje reprezentację tekstową 4-bajtowej liczby całkowitej bez znaku do strumienia tekstu, a następnie terminator wiersza.

WriteLine(UInt64)

Zapisuje reprezentację tekstową 8-bajtowej liczby całkowitej bez znaku do strumienia tekstu, a następnie terminator wiersza.

WriteLineAsync()

Asynchronicznie zapisuje terminator wiersza do strumienia tekstu.

WriteLineAsync(Char)

Asynchronicznie zapisuje znak do strumienia tekstu, po którym następuje terminator wiersza.

WriteLineAsync(Char[])

Asynchronicznie zapisuje tablicę znaków do strumienia tekstu, a następnie terminator wiersza.

WriteLineAsync(Char[], Int32, Int32)

Asynchronicznie zapisuje podarraj znaków do strumienia tekstu, a następnie terminator wiersza.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie zapisuje tekstową reprezentację regionu pamięci znaków w strumieniu tekstowym, a następnie terminator wiersza.

WriteLineAsync(String)

Asynchronicznie zapisuje ciąg w strumieniu tekstowym, a następnie terminator wiersza.

WriteLineAsync(StringBuilder, CancellationToken)

Asynchronicznie zapisuje tekstową reprezentację konstruktora ciągów w strumieniu tekstowym, a następnie terminator wiersza.

Jawne implementacje interfejsu

IDisposable.Dispose()

Aby uzyskać opis tego członka, zobacz Dispose().

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje sposób oczekiwania na zadania zwracane z jednorazowego użytku asynchronicznego.

Dotyczy

Zobacz też