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. Il StreamWriter deriva dalla classe 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 costituiti da valori stringa in un file di testo utilizzando 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 base astratta del StreamWriter e StringWriter, che consentono di scrivere i flussi e le stringhe, rispettivamente.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 le stringhe in un file o per la serializzazione 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 personalizzata usando le stesse API si utilizzerebbe per una stringa o un flusso o 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, un TextWriter 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

Questo tipo implementa la IDisposable interfaccia.This type implements the IDisposable interface. Dopo aver utilizzando qualsiasi tipo che deriva 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 il tipo direttamente, chiamare relativi Dispose metodo in un try / catch blocco.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 altre informazioni, vedere Dispose e la sezione "Utilizzo di oggetti che implementano IDisposable" nel IDisposable argomento relativo all'interfaccia.For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Per un elenco delle attività dei / o comuni, vedere attività dei / 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 della classe utile TextWriter.A 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()
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)

Scrive nel flusso o nella stringa di testo la rappresentazione in forma di testo di un valore Boolean.Writes the text representation of a Boolean value to the text string or stream.

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

Scrive un carattere nella stringa o flusso di testo.Writes a character to the text string or stream.

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

Scrive una matrice di caratteri nella stringa o flusso di testo.Writes a character array to the text string or stream.

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

Scrive una sottomatrice di caratteri nel flusso o nella stringa di testo.Writes a subarray of characters to the text string or stream.

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

Scrive nel flusso o nella stringa di testo la rappresentazione in forma di testo di un valore decimale.Writes the text representation of a decimal value to the text string or stream.

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

Scrive nel flusso o nella stringa di testo la rappresentazione in forma di testo di un valore a virgola mobile a 8 byte.Writes the text representation of an 8-byte floating-point value to the text string or stream.

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

Scrive nel flusso o nella stringa di testo la rappresentazione in forma di testo di un intero a 4 byte con segno.Writes the text representation of a 4-byte signed integer to the text string or stream.

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

Scrive nel flusso o nella stringa di testo la rappresentazione in forma di testo di un intero a 8 byte con segno.Writes the text representation of an 8-byte signed integer to the text string or stream.

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

Scrive nel flusso o nella stringa di testo la rappresentazione in forma di testo di un oggetto chiamando il metodo ToString su tale oggetto.Writes the text representation of an object to the text string or stream by calling the ToString method on that object.

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

Scrive nel flusso o nella stringa di testo la rappresentazione in forma di testo di un valore a virgola mobile a 4 byte.Writes the text representation of a 4-byte floating-point value to the text string or stream.

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

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

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

Scrive una stringa formattata nella stringa o nel flusso di testo, usando la stessa semantica del metodo Format(String, Object).Writes a formatted string to the text string or 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 nella stringa o nel flusso di testo, usando la stessa semantica del metodo Format(String, Object, Object).Writes a formatted string to the text string or 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 nella stringa o nel flusso di testo, usando la stessa semantica del metodo Format(String, Object, Object, Object).Writes a formatted string to the text string or 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 nella stringa o nel flusso di testo, usando la stessa semantica del metodo Format(String, Object[]).Writes a formatted string to the text string or stream, using the same semantics as the Format(String, Object[]) method.

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

Scrive nel flusso o nella stringa di testo la rappresentazione in forma di testo di un intero a 4 byte senza segno.Writes the text representation of a 4-byte unsigned integer to the text string or stream.

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

Scrive nel flusso o nella stringa di testo la rappresentazione in forma di testo di un intero a 8 byte senza segno.Writes the text representation of an 8-byte unsigned integer to the text string or stream.

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

Scrive un carattere in modo asincrono nella stringa o nel flusso di testo.Writes a character to the text string or stream asynchronously.

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

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

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

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

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

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

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

Scrive un terminatore di riga nel flusso o nella stringa di testo.Writes a line terminator to the text string or stream.

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

Scrive la rappresentazione in forma di testo di un valore Boolean, seguita da un terminatore di riga, nella stringa o nel flusso di testo.Writes the text representation of a Boolean value followed by a line terminator to the text string or stream.

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

Scrive nella stringa o nel flusso di testo un carattere seguito da un terminatore di riga.Writes a character followed by a line terminator to the text string or stream.

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

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

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

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

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

Scrive la rappresentazione in forma di testo di un valore decimale, seguita da un terminatore di riga, nella stringa o nel flusso di testo.Writes the text representation of a decimal value followed by a line terminator to the text string or stream.

WriteLine(Double) WriteLine(Double) WriteLine(Double) WriteLine(Double)

Scrive la rappresentazione testuale di un valore a virgola mobile a 8 byte, seguita da un terminatore di riga, nella stringa o nel flusso di testo.Writes the text representation of a 8-byte floating-point value followed by a line terminator to the text string or stream.

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

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

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

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

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

Scrive la rappresentazione testuale di un oggetto chiamando il metodo ToString sull'oggetto, seguita da un terminatore di riga, nella stringa o nel flusso di testo.Writes the text representation of an object by calling the ToString method on that object, followed by a line terminator to the text string or stream.

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

Scrive la rappresentazione testuale di un valore a virgola mobile a 4 byte, seguita da un terminatore di riga, nella stringa o nel flusso di testo.Writes the text representation of a 4-byte floating-point value followed by a line terminator to the text string or stream.

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

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

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

Scrive una stringa formattata e una nuova riga nella stringa o nel flusso di testo, usando la stessa semantica del metodo Format(String, Object).Writes a formatted string and a new line to the text string or 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 nella stringa o 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 string or 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 usando la stessa semantica del metodo Format(String, Object).Writes out a formatted string and a new line, 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 usando la stessa semantica del metodo Format(String, Object).Writes out a formatted string and a new line, using the same semantics as Format(String, Object).

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

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

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

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

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

Scrive un terminatore di riga in modo asincrono nella stringa o nel flusso di testo.Writes a line terminator asynchronously to the text string or stream.

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

Scrive in modo asincrono un carattere seguito da un terminatore di riga nella stringa o nel flusso di testo.Writes a character followed by a line terminator asynchronously to the text string or stream.

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

Scrive in modo asincrono una matrice di caratteri seguita da un terminatore di riga nella stringa o nel flusso di testo.Writes an array of characters followed by a line terminator asynchronously to the text string or stream.

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

Scrive in modo asincrono una sottomatrice di caratteri seguita da un terminatore di riga nella stringa o nel flusso di testo.Writes a subarray of characters followed by a line terminator asynchronously to the text string or stream.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)
WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

Scrive in modo asincrono una stringa seguita da un terminatore di riga nella stringa o nel flusso di testo.Writes a string followed by a line terminator asynchronously to the text string or stream.

WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken)

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