TextWriter Classe

Definizione

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à
TextWriter
Ereditarietà
Derivato
Attributi
Implementazioni

Esempio

La classe TextWriter è astratta. Di conseguenza, non verrà creata un'istanza nel codice. La StreamWriter classe 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 WriteLineAsync(String) metodo .

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 scrive i caratteri in flussi e stringhe, rispettivamente. Creare un'istanza di TextWriter per scrivere un oggetto in una stringa, scrivere stringhe in un file o per serializzare XML. È anche possibile usare un'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 Write metodi di avere tipi di TextWriter dati primitivi come parametri scrivono i valori come stringhe.

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

Importante

Il 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, utilizzare un costrutto di linguaggio come 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 dell'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 Write(Char) metodo 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 oggetto TextWriter senza archivio di backup, in cui è possibile scrivere, ma da cui non è possibile leggere.

Proprietà

Encoding

Se sottoposto a override in una classe derivata, restituisce la codifica caratteri in cui viene scritto l'output.

FormatProvider

Ottiene un oggetto che controlla la formattazione.

NewLine

Recupera o imposta la stringa di terminazione di riga usata dall'oggetto TextWriter corrente.

Metodi

Close()

Chiude il writer corrente e rilascia eventuali risorse di sistema a esso associate.

CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate dall'oggetto TextWriter.

Dispose(Boolean)

Rilascia le risorse non gestite usate da TextWriter e, facoltativamente, 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 i dati di tutti i buffer del writer corrente e consente la scrittura dei dati memorizzati nel buffer nel dispositivo sottostante.

FlushAsync()

Cancella in modo asincrono i dati di tutti i buffer del writer corrente e consente la scrittura dei dati memorizzati nel buffer nel dispositivo sottostante.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLifetimeService()
Obsoleta.

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.

(Ereditato da MarshalByRefObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
InitializeLifetimeService()
Obsoleta.

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

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.

(Ereditato da MarshalByRefObject)
Synchronized(TextWriter)

Crea un wrapper thread-safe per l'oggetto TextWriter specificato.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
Write(Boolean)

Inserisce 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 sottomatrice di caratteri nel flusso di testo.

Write(Decimal)

Scrive nel flusso di testo la rappresentazione testuale di un valore decimale.

Write(Double)

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

Write(Int32)

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

Write(Int64)

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

Write(Object)

Scrive nel flusso di testo la rappresentazione testuale di un oggetto chiamando il metodo ToString su tale oggetto.

Write(ReadOnlySpan<Char>)

Scrive un intervallo di caratteri nel flusso di testo.

Write(Single)

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

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(StringBuilder)

Scrive un generatore di stringhe nel flusso di testo.

Write(UInt32)

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

Write(UInt64)

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

WriteAsync(Char)

Scrive un carattere nel flusso di testo in modo asincrono.

WriteAsync(Char[])

Scrive una matrice di caratteri in modo asincrono nel flusso di testo.

WriteAsync(Char[], Int32, Int32)

Scrive una sottomatrice di caratteri nel flusso di testo in modo asincrono.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Scrive in modo asincrono un'area di memoria dei 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)

Scrivere la rappresentazione testuale di un valore Boolean nel flusso di testo, seguita 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 sottomatrice 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, seguita da un terminatore di riga.

WriteLine(Int32)

Scrive la rappresentazione testuale di un intero a 4 byte con segno nel flusso di testo, seguita da un terminatore di riga.

WriteLine(Int64)

Scrive la rappresentazione testuale di un intero a 8 byte con segno nel flusso di testo, seguita da un terminatore di riga.

WriteLine(Object)

Scrive la rappresentazione testuale di un oggetto nel flusso di testo, chiamando il metodo ToString sull'oggetto, seguita da un terminatore di riga.

WriteLine(ReadOnlySpan<Char>)

Scrive nel flusso di testo la rappresentazione testuale di un intervallo di caratteri, 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, seguita 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(StringBuilder)

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

WriteLine(UInt32)

Scrive la rappresentazione testuale di un intero a 4 byte senza segno nel flusso di testo, seguita da un terminatore di riga.

WriteLine(UInt64)

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

WriteLineAsync()

Scrive in modo asincrono un terminatore di riga nel flusso di testo.

WriteLineAsync(Char)

Scrive un carattere in modo asincrono nel flusso di testo, seguito da un terminatore di riga.

WriteLineAsync(Char[])

Scrive in modo asincrono una matrice di caratteri nel flusso di testo, seguiti da un terminatore di riga.

WriteLineAsync(Char[], Int32, Int32)

Scrive in modo asincrono una sottomatrice di caratteri nel flusso di testo, seguiti da un terminatore di riga.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

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

WriteLineAsync(String)

Scrive una stringa in modo asincrono nel flusso di testo, seguita da un terminatore di riga.

WriteLineAsync(StringBuilder, CancellationToken)

Scrive in modo asincrono nel flusso di testo la rappresentazione testuale di un generatore di stringhe, 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)

Consente di configurare la modalità di esecuzione delle espressioni await per le attività restituite da un elemento disposable asincrono.

Si applica a

Vedi anche