TextWriter Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
-
TextWriter
- Dziedziczenie
- Pochodne
- Atrybuty
- Implementuje
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 |
Null |
Zapewnia magazyn |
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 |
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 |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Write(Boolean) |
Zapisuje tekstową reprezentację |
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 |
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ę |
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 |
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ż
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla