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 klasą abstrakcyjną. W związku z tym, nie tworzy się obiektu w kodzie. Klasa StreamWriter pochodzi z TextWriter elementu i udostępnia implementacje składowych do zapisywania 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 klasy TextWriter.

Konstruktory

TextWriter()

Inicjuje nowe wystąpienie klasy TextWriter.
TextWriter(IFormatProvider)

Inicjuje TextWriter nowe wystąpienie klasy za pomocą określonego dostawcy formatu.

Pola

CoreNewLine

Przechowuje nowe znaki wiersza używane dla tego TextWriterelementu .
Null

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

Właściwości

Encoding

Po zastąpieniu klasy pochodnej zwraca kodowanie znaków, w którym są zapisywane dane wyjściowe.
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 składnik 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 modułu zapisywania i powoduje zapisanie wszystkich buforowanych danych na urządzeniu bazowym.
FlushAsync()

Asynchronicznie czyści wszystkie bufory dla bieżącego modułu zapisywania i powoduje zapisanie wszystkich buforowanych danych na urządzeniu bazowym.
FlushAsync(CancellationToken)

Asynchronicznie czyści wszystkie bufory dla bieżącego modułu 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 bieżące wystąpienie.

(Odziedziczone po Object)
InitializeLifetimeService()
Przestarzałe.

Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady 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 tekstową reprezentację wartości dziesiętnej w strumieniu tekstowym.
Write(Double)

Zapisuje tekstową reprezentację wartości zmiennoprzecinkowej 8 bajtów na strumień tekstowy.
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ę tekstu obiektu w strumieniu tekstowym, wywołując ToString metodę na tym obiekcie, a następnie terminator wiersza.
WriteLine(ReadOnlySpan<Char>)

Zapisuje tekstową reprezentację zakresu znaków w strumieniu tekstowym, a następnie terminator wiersza.
WriteLine(Single)

Zapisuje tekstową reprezentację wartości zmiennoprzecinkowej 4-bajtowej do strumienia tekstowego, po której następuje terminator wiersza.
WriteLine(String)

Zapisuje ciąg do strumienia tekstu, po którym następuje terminator wiersza.
WriteLine(String, Object)

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tych samych 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, a następnie terminator wiersza.
WriteLine(UInt32)

Zapisuje reprezentację tekstową 4-bajtowej liczby całkowitej bez znaku do strumienia tekstowego, po której następuje 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 elementu członkowskiego, zobacz Dispose().

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje sposób oczekiwania na zadania zwracane z asynchronicznego jednorazowego wykonania.

Dotyczy

Zobacz też