TextWriter TextWriter TextWriter TextWriter Class

Definizione

Rappresenta un writer in grado di scrivere una serie sequenziale di caratteri.Represents a writer that can write a sequential series of characters. Questa classe è astratta.This class is abstract.

public ref class TextWriter abstract : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable
Ereditarietà
Derivato
Attributi
Implementazioni

Esempi

La classe TextWriter è una classe astratta.The TextWriter class is an abstract class. Di conseguenza, non verrà creata un'istanza nel codice.Therefore, you do not instantiate it in your code. La StreamWriter classe deriva da TextWriter e fornisce le implementazioni dei membri per la scrittura in un flusso.The StreamWriter class derives from TextWriter and provides implementations of the members for writing to a stream. Nell'esempio seguente viene illustrato come scrivere due righe costituite da valori stringa in un file di testo tramite il WriteLineAsync(String) metodo.The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String) method.

Eseguire l'override di Dispose in una classe derivata per fornireOverride Dispose in a derived class to provide

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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 di base astratta StreamWriter di StringWritere, che scrivono rispettivamente i caratteri in flussi e stringhe.TextWriter is the abstract base class of StreamWriter and StringWriter, which write characters to streams and strings, respectively. Creare un'istanza di TextWriter per scrivere un oggetto in una stringa, scrivere stringhe in un file o serializzare XML.Create an instance of TextWriter to write an object to a string, write strings to a file, or to serialize 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.You can also use an instance of TextWriter to write text to a custom backing store using the same APIs you would use for a string or a stream, or to add support for text formatting.

Tutti i Write metodi di TextWriter con tipi di dati primitivi come parametri scrivono i valori come stringhe.All the Write methods of TextWriter having primitive data types as parameters write out the values as strings.

Per impostazione predefinita, TextWriter un oggetto non è thread-safe.By default, a TextWriter is not thread safe. Vedere TextWriter.Synchronized per un wrapper thread-safe.See TextWriter.Synchronized for a thread-safe wrapper.

Importante

Il tipo implementa l'interfaccia IDisposable.This type implements the IDisposable interface. Al termine dell'utilizzo di qualsiasi tipo derivato da questo tipo, è necessario eliminarlo direttamente o indirettamente.When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. Per eliminare direttamente il tipo, chiamare il metodo Dispose in un blocco try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Per eliminarlo indirettamente, utilizzare un costrutto di linguaggio come ad esempio using in C# o Using in Visual Basic.To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Per ulteriori informazioni, vedere la sezione Dispose e l'argomento relativo all'utilizzo di un oggetto che IDisposable implementa IDisposable nell'argomento Interface.For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Note per gli eredi

Una classe derivata deve implementare almeno il Write(Char) metodo per creare un'istanza utile di. TextWriterA derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

Costruttori

TextWriter() TextWriter() TextWriter() TextWriter()

Inizializza una nuova istanza della classe TextWriter.Initializes a new instance of the TextWriter class.

TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider)

Inizializza una nuova istanza della classe TextWriter con il provider di formato specificato.Initializes a new instance of the TextWriter class with the specified format provider.

Campi

CoreNewLine CoreNewLine CoreNewLine CoreNewLine

Archivia i caratteri di nuova riga usati per questo TextWriter.Stores the newline characters used for this TextWriter.

Null Null Null Null

Fornisce un oggetto TextWriter senza archivio di backup, in cui è possibile scrivere, ma da cui non è possibile leggere.Provides a TextWriter with no backing store that can be written to, but not read from.

Proprietà

Encoding Encoding Encoding Encoding

Se sottoposto a override in una classe derivata, restituisce la codifica caratteri in cui viene scritto l'output.When overridden in a derived class, returns the character encoding in which the output is written.

FormatProvider FormatProvider FormatProvider FormatProvider

Ottiene un oggetto che controlla la formattazione.Gets an object that controls formatting.

NewLine NewLine NewLine NewLine

Recupera o imposta la stringa di terminazione di riga usata dall'oggetto TextWriter corrente.Gets or sets the line terminator string used by the current TextWriter.

Metodi

Close() Close() Close() Close()

Chiude il writer corrente e rilascia eventuali risorse di sistema a esso associate.Closes the current writer and releases any system resources associated with the writer.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate dall'oggetto TextWriter.Releases all resources used by the TextWriter object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite usate da TextWriter e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()

Rilascia in modo asincrono tutte le risorse usate dall'oggetto TextWriter.Asynchronously releases all resources used by the TextWriter object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

Cancella i dati di tutti i buffer del writer corrente e consente la scrittura dei dati memorizzati nel buffer nel dispositivo sottostante.Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

FlushAsync() FlushAsync() FlushAsync() 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.Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter)

Crea un wrapper thread-safe per l'oggetto TextWriter specificato.Creates a thread-safe wrapper around the specified TextWriter.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
Write(Boolean) Write(Boolean) Write(Boolean) Write(Boolean)

Inserisce nel flusso di testo la rappresentazione testuale di un valore Boolean.Writes the text representation of a Boolean value to the text stream.

Write(Char) Write(Char) Write(Char) Write(Char)

Scrive un carattere nel flusso di testo.Writes a character to the text stream.

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

Scrive una matrice di caratteri nel flusso di testo.Writes a character array to the text stream.

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Scrive una sottomatrice di caratteri nel flusso di testo.Writes a subarray of characters to the text stream.

Write(Decimal) Write(Decimal) Write(Decimal) Write(Decimal)

Scrive nel flusso di testo la rappresentazione testuale di un valore decimale.Writes the text representation of a decimal value to the text stream.

Write(Double) Write(Double) Write(Double) Write(Double)

Scrive nel flusso di testo la rappresentazione testuale di un valore a virgola mobile a 8 byte.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Int32) Write(Int32) Write(Int32) Write(Int32)

Scrive nel flusso di testo la rappresentazione testuale di un intero a 4 byte con segno.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Int64) Write(Int64) Write(Int64) Write(Int64)

Scrive nel flusso di testo la rappresentazione testuale di un intero a 8 byte con segno.Writes the text representation of an 8-byte signed integer to the text stream.

Write(Object) Write(Object) Write(Object) Write(Object)

Scrive nel flusso di testo la rappresentazione testuale di un oggetto chiamando il metodo ToString su tale oggetto.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

Scrive un intervallo di caratteri nel flusso di testo.Writes a character span to the text stream.

Write(Single) Write(Single) Write(Single) Write(Single)

Scrive nel flusso di testo la rappresentazione testuale di un valore a virgola mobile a 4 byte.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String) Write(String) Write(String) Write(String)

Scrive una stringa nel flusso di testo.Writes a string to the text stream.

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object, Object).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, 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).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

Scrive una stringa formattata nel flusso di testo, usando la stessa semantica del metodo Format(String, Object[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(StringBuilder) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)

Scrive un generatore di stringhe nel flusso di testo.Writes a string builder to the text stream.

Write(UInt32) Write(UInt32) Write(UInt32) Write(UInt32)

Scrive nel flusso di testo la rappresentazione testuale di un intero a 4 byte senza segno.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(UInt64) Write(UInt64) Write(UInt64) Write(UInt64)

Scrive nel flusso di testo la rappresentazione testuale di un intero a 8 byte senza segno.Writes the text representation of an 8-byte unsigned integer to the text stream.

WriteAsync(Char) WriteAsync(Char) WriteAsync(Char) WriteAsync(Char)

Scrive un carattere nel flusso di testo in modo asincrono.Writes a character to the text stream asynchronously.

WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[])

Scrive una matrice di caratteri in modo asincrono nel flusso di testo.Writes a character array to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32)

Scrive una sottomatrice di caratteri nel flusso di testo in modo asincrono.Writes a subarray of characters to the text stream asynchronously.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Scrive in modo asincrono un'area di memoria dei caratteri nel flusso di testo.Asynchronously writes a character memory region to the text stream.

WriteAsync(String) WriteAsync(String) WriteAsync(String) WriteAsync(String)

Scrive una stringa nel flusso di testo in modo asincrono.Writes a string to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken)

Scrive in modo asincrono un generatore di stringhe nel flusso di testo.Asynchronously writes a string builder to the text stream.

WriteLine() WriteLine() WriteLine() WriteLine()

Scrive un terminatore di riga nel flusso di testo.Writes a line terminator to the text stream.

WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean)

Scrivere la rappresentazione testuale di un valore Boolean nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine(Char) WriteLine(Char) WriteLine(Char) WriteLine(Char)

Scrive un carattere nel flusso di testo, seguito da un terminatore di riga.Writes a character to the text stream, followed by a line terminator.

WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[])

Scrive una matrice di caratteri nel flusso di testo, seguita da un terminatore di riga.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32)

Scrive una sottomatrice di caratteri nel flusso di testo, seguita da un terminatore di riga.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal)

Scrive la rappresentazione testuale di un valore decimale nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Double) WriteLine(Double) WriteLine(Double) 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.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Int32) WriteLine(Int32) WriteLine(Int32) WriteLine(Int32)

Scrive la rappresentazione testuale di un intero a 4 byte con segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int64) WriteLine(Int64) WriteLine(Int64) WriteLine(Int64)

Scrive la rappresentazione testuale di un intero a 8 byte con segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Object) WriteLine(Object) WriteLine(Object) 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.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>)

Scrive nel flusso di testo la rappresentazione testuale di un intervallo di caratteri, seguita da un terminatore di riga.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(Single) WriteLine(Single) WriteLine(Single) 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.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Scrive una stringa nel flusso di testo, seguita da un terminatore di riga.Writes a string to the text stream, followed by a line terminator.

WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object)

Scrive una stringa formattata e una nuova riga nel flusso di testo, usando la stessa semantica del metodo Format(String, Object).Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object) method.

WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, 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).Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object, Object) method.

WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, 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).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(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).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder)

Scrive nel flusso di testo la rappresentazione testuale di un generatore di stringhe, seguita da un terminatore di riga.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32)

Scrive la rappresentazione testuale di un intero a 4 byte senza segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64)

Scrive la rappresentazione testuale di un intero a 8 byte senza segno nel flusso di testo, seguita da un terminatore di riga.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLineAsync() WriteLineAsync() WriteLineAsync() WriteLineAsync()

Scrive in modo asincrono un terminatore di riga nel flusso di testo.Asynchronously writes a line terminator to the text stream.

WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char)

Scrive un carattere in modo asincrono nel flusso di testo, seguito da un terminatore di riga.Asynchronously writes a character to the text stream, followed by a line terminator.

WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[])

Scrive in modo asincrono una matrice di caratteri nel flusso di testo, seguiti da un terminatore di riga.Asynchronously writes an array of characters to the text stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32)

Scrive in modo asincrono una sottomatrice di caratteri nel flusso di testo, seguiti da un terminatore di riga.Asynchronously writes a subarray of characters to the text stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) 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.Asynchronously writes the text representation of a character memory region to the text stream, followed by a line terminator.

WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

Scrive una stringa in modo asincrono nel flusso di testo, seguita da un terminatore di riga.Asynchronously writes a string to the text stream, followed by a line terminator.

WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) 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.Asynchronously writes the text representation of a string builder to the text stream, followed by a line terminator.

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Per una descrizione di questo membro, vedere Dispose().For a description of this member, see Dispose().

Si applica a

Vedi anche