TextWriter Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origine:
TextWriter.cs
Origine:
TextWriter.cs
Origine:
TextWriter.cs

Rappresenta un writer in grado di scrivere una serie sequenziale di caratteri. Questa classe è astratta.

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
Ereditarietà
Object
TextWriter
Ereditarietà
Object
MarshalByRefObject
TextWriter
Derivato
Attributi
SerializableAttribute ComVisibleAttribute
Implementazioni
IDisposable IAsyncDisposable

Esempio

La classe TextWriter è una classe astratta. Di conseguenza, non è necessario crearne un'istanza nel codice. La classe StreamWriter deriva da TextWriter e fornisce implementazioni dei membri per la scrittura in un flusso. Nell'esempio seguente viene illustrato come scrivere due righe costituite da valori stringa in un file di testo usando il metodo WriteLineAsync(String).

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

Commenti

TextWriter è la classe base astratta di StreamWriter e StringWriter, che scrivono rispettivamente caratteri in flussi e stringhe. Utilizzare un'istanza di TextWriter per scrivere un oggetto in una stringa, scrivere stringhe in un file o serializzare XML. È anche possibile usare l'istanza di TextWriter per scrivere testo in un archivio di backup personalizzato usando le stesse API usate per una stringa o un flusso oppure per aggiungere il supporto per la formattazione del testo.

Tutti i metodi Write di TextWriter con tipi di dati primitivi come parametri scrivono i valori come stringhe.

Per impostazione predefinita, un TextWriter non è thread-safe. Vedere TextWriter.Synchronized per un wrapper thread-safe.

Importante

Questo tipo implementa l'interfaccia IDisposable. Al termine dell'uso di qualsiasi tipo che deriva da questo tipo, è necessario eliminarlo direttamente o indirettamente. Per eliminare direttamente il tipo, chiamare il metodo Dispose in un blocco try/catch. Per eliminarlo indirettamente, usare un costrutto del linguaggio, ad esempio using (in C#) o Using (in Visual Basic). Per altre informazioni, vedere Dispose e la sezione "Using an Object that Implements IDisposable" nell'argomento relativo all'interfaccia IDisposable.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Note per gli implementatori

Una classe derivata deve implementare minimamente il metodo Write(Char) per rendere un'istanza utile di TextWriter.

Costruttori

TextWriter()

Inizializza una nuova istanza della classe TextWriter.
TextWriter(IFormatProvider)

Inizializza una nuova istanza della classe TextWriter con il provider di formato specificato.

Campi

CoreNewLine

Archivia i caratteri di nuova riga usati per questo TextWriter.
Null

Fornisce un TextWriter senza archivio di backup in cui è possibile scrivere, ma non leggere.

Proprietà

Encoding

In caso di override in una classe derivata, restituisce la codifica dei caratteri in cui viene scritto l'output.
FormatProvider

Ottiene un oggetto che controlla la formattazione.
NewLine

Ottiene o imposta la stringa del terminatore di riga utilizzata dal TextWritercorrente.

Metodi

Close()

Chiude il writer corrente e rilascia tutte le risorse di sistema associate al writer.
CreateBroadcasting(TextWriter[])

Crea un'istanza di TextWriter che scrive gli input forniti in ognuno dei writer in writers.
CreateObjRef(Type)

Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate dall'oggetto TextWriter.
Dispose(Boolean)

Rilascia le risorse non gestite usate dal TextWriter e, facoltativamente, rilascia le risorse gestite.
DisposeAsync()

Rilascia in modo asincrono tutte le risorse usate dall'oggetto TextWriter.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Flush()

Cancella tutti i buffer per il writer corrente e determina la scrittura di tutti i dati memorizzati nel buffer nel dispositivo sottostante.
FlushAsync()

Cancella in modo asincrono tutti i buffer per il writer corrente e determina la scrittura di tutti i dati memorizzati nel buffer nel dispositivo sottostante.
FlushAsync(CancellationToken)

Cancella in modo asincrono tutti i buffer per il writer corrente e determina la scrittura di tutti i dati memorizzati nel buffer nel dispositivo sottostante.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLifetimeService()
Obsoleti.

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
InitializeLifetimeService()
Obsoleti.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia superficiale dell'oggetto MarshalByRefObject corrente.

(Ereditato da MarshalByRefObject)
Synchronized(TextWriter)

Crea un wrapper thread-safe intorno al TextWriterspecificato.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
Write(Boolean)

Scrive nel flusso di testo la rappresentazione testuale di un valore Boolean.
Write(Char)

Scrive un carattere nel flusso di testo.
Write(Char[])

Scrive una matrice di caratteri nel flusso di testo.
Write(Char[], Int32, Int32)

Scrive una sottomaschera di caratteri nel flusso di testo.
Write(Decimal)

Scrive la rappresentazione testuale di un valore decimale nel flusso di testo.
Write(Double)

Scrive la rappresentazione testuale di un valore a virgola mobile a 8 byte nel flusso di testo.
Write(Int32)

Scrive la rappresentazione testuale di un intero con segno a 4 byte nel flusso di testo.
Write(Int64)

Scrive la rappresentazione testuale di un intero con segno a 8 byte nel flusso di testo.
Write(Object)

Scrive la rappresentazione testuale di un oggetto nel flusso di testo chiamando il metodo ToString su tale oggetto.
Write(ReadOnlySpan<Char>)

Scrive un intervallo di caratteri nel flusso di testo.
Write(Single)

Scrive la rappresentazione testuale di un valore a virgola mobile a 4 byte nel flusso di testo.
Write(String)

Scrive una stringa nel flusso di testo.
Write(String, Object)

Scrive una stringa formattata nel flusso di testo usando la stessa semantica del metodo Format(String, Object).
Write(String, Object, Object)

Scrive una stringa formattata nel flusso di testo usando la stessa semantica del metodo Format(String, Object, Object).
Write(String, Object, Object, Object)

Scrive una stringa formattata nel flusso di testo usando la stessa semantica del metodo Format(String, Object, Object, Object).
Write(String, Object[])

Scrive una stringa formattata nel flusso di testo usando la stessa semantica del metodo Format(String, Object[]).
Write(String, ReadOnlySpan<Object>)

Scrive una stringa formattata nel flusso di testo usando la stessa semantica di Format(String, ReadOnlySpan<Object>).
Write(StringBuilder)

Scrive un generatore di stringhe nel flusso di testo.
Write(UInt32)

Scrive nel flusso di testo la rappresentazione testuale di un intero senza segno a 4 byte.
Write(UInt64)

Scrive la rappresentazione testuale di un intero senza segno a 8 byte nel flusso di testo.
WriteAsync(Char)

Scrive un carattere nel flusso di testo in modo asincrono.
WriteAsync(Char[])

Scrive una matrice di caratteri nel flusso di testo in modo asincrono.
WriteAsync(Char[], Int32, Int32)

Scrive una sottomaschera di caratteri nel flusso di testo in modo asincrono.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Scrive in modo asincrono un'area di memoria di caratteri nel flusso di testo.
WriteAsync(String)

Scrive una stringa nel flusso di testo in modo asincrono.
WriteAsync(StringBuilder, CancellationToken)

Scrive in modo asincrono un generatore di stringhe nel flusso di testo.
WriteLine()

Scrive un terminatore di riga nel flusso di testo.
WriteLine(Boolean)

Scrive la rappresentazione testuale di un valore Boolean nel flusso di testo, seguito da un terminatore di riga.
WriteLine(Char)

Scrive un carattere nel flusso di testo, seguito da un terminatore di riga.
WriteLine(Char[])

Scrive una matrice di caratteri nel flusso di testo, seguita da un terminatore di riga.
WriteLine(Char[], Int32, Int32)

Scrive una sottomaschera di caratteri nel flusso di testo, seguita da un terminatore di riga.
WriteLine(Decimal)

Scrive la rappresentazione testuale di un valore decimale nel flusso di testo, seguita da un terminatore di riga.
WriteLine(Double)

Scrive la rappresentazione testuale di un valore a virgola mobile a 8 byte nel flusso di testo, seguito da un terminatore di riga.
WriteLine(Int32)

Scrive la rappresentazione testuale di un intero con segno a 4 byte nel flusso di testo, seguito da un terminatore di riga.
WriteLine(Int64)

Scrive la rappresentazione testuale di un intero con segno a 8 byte nel flusso di testo, seguito da un terminatore di riga.
WriteLine(Object)

Scrive la rappresentazione testuale di un oggetto nel flusso di testo chiamando il metodo ToString su tale oggetto, seguito da un terminatore di riga.
WriteLine(ReadOnlySpan<Char>)

Scrive la rappresentazione testuale di un intervallo di caratteri nel flusso di testo, seguita da un terminatore di riga.
WriteLine(Single)

Scrive la rappresentazione testuale di un valore a virgola mobile a 4 byte nel flusso di testo, seguito da un terminatore di riga.
WriteLine(String)

Scrive una stringa nel flusso di testo, seguita da un terminatore di riga.
WriteLine(String, Object)

Scrive una stringa formattata e una nuova riga nel flusso di testo, usando la stessa semantica del metodo Format(String, Object).
WriteLine(String, Object, Object)

Scrive una stringa formattata e una nuova riga nel flusso di testo, usando la stessa semantica del metodo Format(String, Object, Object).
WriteLine(String, Object, Object, Object)

Scrive una stringa formattata e una nuova riga nel flusso di testo, usando la stessa semantica di Format(String, Object).
WriteLine(String, Object[])

Scrive una stringa formattata e una nuova riga nel flusso di testo, usando la stessa semantica di Format(String, Object).
WriteLine(String, ReadOnlySpan<Object>)

Scrive una stringa formattata e una nuova riga nel flusso di testo, usando la stessa semantica di Format(String, ReadOnlySpan<Object>).
WriteLine(StringBuilder)

Scrive la rappresentazione testuale di un generatore di stringhe nel flusso di testo, seguita da un terminatore di riga.
WriteLine(UInt32)

Scrive la rappresentazione testuale di un intero senza segno a 4 byte nel flusso di testo, seguito da un terminatore di riga.
WriteLine(UInt64)

Scrive la rappresentazione testuale di un intero senza segno a 8 byte nel flusso di testo, seguito da un terminatore di riga.
WriteLineAsync()

Scrive in modo asincrono un terminatore di riga nel flusso di testo.
WriteLineAsync(Char)

Scrive in modo asincrono un carattere nel flusso di testo, seguito da un terminatore di riga.
WriteLineAsync(Char[])

Scrive in modo asincrono una matrice di caratteri nel flusso di testo, seguita da un terminatore di riga.
WriteLineAsync(Char[], Int32, Int32)

Scrive in modo asincrono una sottomaschera di caratteri nel flusso di testo, seguita da un terminatore di riga.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Scrive in modo asincrono la rappresentazione testuale di un'area di memoria di caratteri nel flusso di testo, seguita da un terminatore di riga.
WriteLineAsync(String)

Scrive in modo asincrono una stringa nel flusso di testo, seguita da un terminatore di riga.
WriteLineAsync(StringBuilder, CancellationToken)

Scrive in modo asincrono la rappresentazione testuale di un generatore di stringhe nel flusso di testo, seguita da un terminatore di riga.

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose()

Per una descrizione di questo membro, vedere Dispose().

Metodi di estensione

ConfigureAwait(IAsyncDisposable, Boolean)

Configura il modo in cui verranno eseguite le attese nelle attività restituite da un oggetto eliminabile asincrono.

Si applica a

Vedi anche