TextWriter Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestaw:
System.IO.dll
Zestaw:
System.Runtime.dll
Zestaw:
System.Runtime.Extensions.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Źródło:
TextWriter.cs
Źródło:
TextWriter.cs
Źródło:
TextWriter.cs

Reprezentuje składnik zapisywania, 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
Object
TextWriter
Dziedziczenie
Object
MarshalByRefObject
TextWriter
Pochodne
Atrybuty
SerializableAttribute ComVisibleAttribute
Implementuje
IDisposable IAsyncDisposable

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 WriteLineAsync(String) przy użyciu 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 StreamWriterStringWriter, która zapisuje znaki w strumieniach i ciągach, odpowiednio. Użyj wystąpienia, TextWriter aby zapisać obiekt w ciągu, zapisać ciągi w pliku lub serializować kod XML. Możesz również użyć wystąpienia TextWriter , aby napisać tekst do niestandardowego magazynu kopii zapasowych 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 TextWriter element nie jest bezpieczny wątkiem. Zobacz, aby zapoznać się TextWriter.Synchronized z otoką bezpieczną wątkowo.

Ważne

Ten typ implementuje IDisposable interfejs. Po zakończeniu używania dowolnego typu pochodzącego z tego typu należy usunąć go bezpośrednio lub pośrednio. Aby usunąć typ bezpośrednio, wywołaj metodę Disposetry/catch w bloku. Aby usunąć go pośrednio, użyj konstrukcji językowej, takiej jak using (w języku C#) lub Using (w Visual Basic). Aby uzyskać więcej informacji, zobacz usuwanie i sekcję "Using an Object that Implements IDisposable" (Używanie obiektu implementujące 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.
CreateBroadcasting(TextWriter[])

Reprezentuje składnik zapisywania, który może napisać sekwencyjną serię znaków. Ta klasa jest abstrakcyjna.
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.
FlushAsync(CancellationToken)

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()
Przestarzałe.

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()
Przestarzałe.

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 podtablicę 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 reprezentację tekstową 8-bajtowej liczby całkowitej ze znakiem do strumienia tekstu.
Write(Object)

Zapisuje reprezentację tekstową 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 reprezentację tekstową 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 tej samej semantyki co Format(String, Object) metoda.
Write(String, Object, Object)

Zapisuje sformatowany ciąg do strumienia tekstowego przy użyciu tej samej semantyki co Format(String, Object, Object) metoda.
Write(String, Object, Object, Object)

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

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

Zapisuje konstruktora ciągów w strumieniu tekstowym.
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 w strumieniu tekstowym asynchronicznie.
WriteAsync(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym asynchronicznie.
WriteAsync(Char[], Int32, Int32)

Zapisuje podtablicę znaków w strumieniu tekstowym asynchronicznie.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie zapisuje obszar pamięci znaków w strumieniu tekstu.
WriteAsync(String)

Zapisuje ciąg w strumieniu tekstowym asynchronicznie.
WriteAsync(StringBuilder, CancellationToken)

Asynchronicznie zapisuje konstruktora ciągów w strumieniu tekstowym.
WriteLine()

Zapisuje terminator wiersza w strumieniu tekstowym.
WriteLine(Boolean)

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

Zapisuje znak w strumieniu tekstowym, po którym następuje terminator wiersza.
WriteLine(Char[])

Zapisuje tablicę znaków w strumieniu tekstowym, po którym następuje terminator wiersza.
WriteLine(Char[], Int32, Int32)

Zapisuje podtablicę znaków do strumienia tekstu, a następnie terminator wiersza.
WriteLine(Decimal)

Zapisuje reprezentację tekstową wartości dziesiętnej w strumieniu tekstowym, a następnie terminator wiersza.
WriteLine(Double)

Zapisuje reprezentację tekstową 8-bajtowej wartości zmiennoprzecinkowej do strumienia tekstowego, a następnie terminator linii.
WriteLine(Int32)

Zapisuje reprezentację tekstową 4-bajtowej liczby całkowitej ze znakiem do strumienia tekstu, a następnie terminator wiersza.
WriteLine(Int64)

Zapisuje reprezentację tekstową 8-bajtowej liczby całkowitej ze znakiem 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 tej samej 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 tej samej semantyki co Format(String, Object).
WriteLine(String, Object[])

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tej samej 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 linii w strumieniu tekstowym.
WriteLineAsync(Char)

Asynchronicznie zapisuje znak w strumieniu tekstowym, po którym następuje terminator wiersza.
WriteLineAsync(Char[])

Asynchronicznie zapisuje tablicę znaków w strumieniu tekstowym, a następnie terminator wiersza.
WriteLineAsync(Char[], Int32, Int32)

Asynchronicznie zapisuje podtablicę znaków w strumieniu tekstowym, a następnie terminator wiersza.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchronicznie zapisuje tekstową reprezentację regionu pamięci znaków w strumieniu tekstu, a następnie terminator wiersza.
WriteLineAsync(String)

Asynchronicznie zapisuje ciąg w strumieniu tekstowym, po którym następuje 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ż