IndentedTextWriter Classe

Definizione

Spazio dei nomi:

System.CodeDom.Compiler

Assembly:

System.Runtime.dll

Origine:

IndentedTextWriter.cs

Fornisce un writer di testo che può impostare un rientro di nuove righe in base a un token di stringa di tabulazioni.

public ref class IndentedTextWriter : System::IO::TextWriter

public class IndentedTextWriter : System.IO.TextWriter

type IndentedTextWriter = class
    inherit TextWriter

Public Class IndentedTextWriter
Inherits TextWriter

Ereditarietà

Object

MarshalByRefObject

TextWriter

IndentedTextWriter

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di un IndentedTextWriter per scrivere testo a livelli diversi di rientro.

#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>
#using <System.dll>

using namespace System;
using namespace System::CodeDom;
using namespace System::CodeDom::Compiler;
using namespace System::ComponentModel;
using namespace System::IO;
using namespace System::Windows::Forms;
public ref class Form1: public System::Windows::Forms::Form
{
private:
   System::Windows::Forms::TextBox^ textBox1;

   String^ CreateMultilevelIndentString()
   {
      
      // Creates a TextWriter to use as the base output writer.
      System::IO::StringWriter^ baseTextWriter = gcnew System::IO::StringWriter;
      
      // Create an IndentedTextWriter and set the tab string to use 
      // as the indentation string for each indentation level.
      System::CodeDom::Compiler::IndentedTextWriter^ indentWriter = gcnew IndentedTextWriter( baseTextWriter,"    " );
      
      // Sets the indentation level.
      indentWriter->Indent = 0;
      
      // Output test strings at stepped indentations through a recursive loop method.
      WriteLevel( indentWriter, 0, 5 );
      
      // Return the resulting string from the base StringWriter.
      return baseTextWriter->ToString();
   }


   void WriteLevel( IndentedTextWriter^ indentWriter, int level, int totalLevels )
   {
      
      // Output a test string with a new-line character at the end.
      indentWriter->WriteLine( "This is a test phrase. Current indentation level: {0}", level );
      
      // If not yet at the highest recursion level, call this output method for the next level of indentation.
      if ( level < totalLevels )
      {
         
         // Increase the indentation count for the next level of indented output.
         indentWriter->Indent++;
         
         // Call the WriteLevel method to write test output for the next level of indentation.
         WriteLevel( indentWriter, level + 1, totalLevels );
         
         // Restores the indentation count for this level after the recursive branch method has returned.
         indentWriter->Indent--;
      }
      else
      // Outputs a string using the WriteLineNoTabs method.
            indentWriter->WriteLineNoTabs( "This is a test phrase written with the IndentTextWriter.WriteLineNoTabs method." );
      // Outputs a test string with a new-line character at the end.
      indentWriter->WriteLine( "This is a test phrase. Current indentation level: {0}", level );
   }


   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      textBox1->Text = CreateMultilevelIndentString();
   }


public:
   Form1()
   {
      System::Windows::Forms::Button^ button1 = gcnew System::Windows::Forms::Button;
      this->textBox1 = gcnew System::Windows::Forms::TextBox;
      this->SuspendLayout();
      this->textBox1->Anchor = (System::Windows::Forms::AnchorStyles)(System::Windows::Forms::AnchorStyles::Top | System::Windows::Forms::AnchorStyles::Bottom | System::Windows::Forms::AnchorStyles::Left | System::Windows::Forms::AnchorStyles::Right);
      this->textBox1->Location = System::Drawing::Point( 8, 40 );
      this->textBox1->Multiline = true;
      this->textBox1->Name = "textBox1";
      this->textBox1->Size = System::Drawing::Size( 391, 242 );
      this->textBox1->TabIndex = 0;
      this->textBox1->Text = "";
      button1->Location = System::Drawing::Point( 11, 8 );
      button1->Name = "button1";
      button1->Size = System::Drawing::Size( 229, 23 );
      button1->TabIndex = 1;
      button1->Text = "Generate string using IndentedTextWriter";
      button1->Click += gcnew System::EventHandler( this, &Form1::button1_Click );
      this->AutoScaleBaseSize = System::Drawing::Size( 5, 13 );
      this->ClientSize = System::Drawing::Size( 407, 287 );
      this->Controls->Add( button1 );
      this->Controls->Add( this->textBox1 );
      this->Name = "Form1";
      this->Text = "IndentedTextWriter example";
      this->ResumeLayout( false );
   }

};


[STAThread]
int main()
{
   Application::Run( gcnew Form1 );
}

using System;
using System.CodeDom;
using System.CodeDom.Compiler;
using System.ComponentModel;
using System.IO;
using System.Windows.Forms;

namespace IndentedTextWriterExample
{
    public class Form1 : System.Windows.Forms.Form
    {
        private System.Windows.Forms.TextBox textBox1;

        private string CreateMultilevelIndentString()
        {
            // Creates a TextWriter to use as the base output writer.
            System.IO.StringWriter baseTextWriter = new System.IO.StringWriter();

            // Create an IndentedTextWriter and set the tab string to use
            // as the indentation string for each indentation level.
            System.CodeDom.Compiler.IndentedTextWriter indentWriter = new IndentedTextWriter(baseTextWriter, "    ");

            // Sets the indentation level.
            indentWriter.Indent = 0;

            // Output test strings at stepped indentations through a recursive loop method.
            WriteLevel(indentWriter, 0, 5);

            // Return the resulting string from the base StringWriter.
            return baseTextWriter.ToString();
        }

        private void WriteLevel(IndentedTextWriter indentWriter, int level, int totalLevels)
        {
            // Output a test string with a new-line character at the end.
            indentWriter.WriteLine("This is a test phrase. Current indentation level: "+level.ToString());

            // If not yet at the highest recursion level, call this output method for the next level of indentation.
            if( level < totalLevels )
            {
                // Increase the indentation count for the next level of indented output.
                indentWriter.Indent++;

                // Call the WriteLevel method to write test output for the next level of indentation.
                WriteLevel(indentWriter, level+1, totalLevels);

                // Restores the indentation count for this level after the recursive branch method has returned.
                indentWriter.Indent--;
            }
            else
            {
                // Outputs a string using the WriteLineNoTabs method.
                indentWriter.WriteLineNoTabs("This is a test phrase written with the IndentTextWriter.WriteLineNoTabs method.");
            }

            // Outputs a test string with a new-line character at the end.
            indentWriter.WriteLine("This is a test phrase. Current indentation level: "+level.ToString());
        }

        private void button1_Click(object sender, System.EventArgs e)
        {
            textBox1.Text = CreateMultilevelIndentString();
        }

        public Form1()
        {
            System.Windows.Forms.Button button1 = new System.Windows.Forms.Button();
            this.textBox1 = new System.Windows.Forms.TextBox();
            this.SuspendLayout();
            this.textBox1.Anchor = ((System.Windows.Forms.AnchorStyles)((((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Bottom)
                | System.Windows.Forms.AnchorStyles.Left)
                | System.Windows.Forms.AnchorStyles.Right)));
            this.textBox1.Location = new System.Drawing.Point(8, 40);
            this.textBox1.Multiline = true;
            this.textBox1.Name = "textBox1";
            this.textBox1.Size = new System.Drawing.Size(391, 242);
            this.textBox1.TabIndex = 0;
            this.textBox1.Text = "";
            button1.Location = new System.Drawing.Point(11, 8);
            button1.Name = "button1";
            button1.Size = new System.Drawing.Size(229, 23);
            button1.TabIndex = 1;
            button1.Text = "Generate string using IndentedTextWriter";
            button1.Click += new System.EventHandler(this.button1_Click);
            this.AutoScaleBaseSize = new System.Drawing.Size(5, 13);
            this.ClientSize = new System.Drawing.Size(407, 287);
            this.Controls.Add(button1);
            this.Controls.Add(this.textBox1);
            this.Name = "Form1";
            this.Text = "IndentedTextWriter example";
            this.ResumeLayout(false);
        }

        [STAThread]
        static void Main()
        {
            Application.Run(new Form1());
        }
    }
}

Imports System.CodeDom
Imports System.CodeDom.Compiler
Imports System.ComponentModel
Imports System.IO
Imports System.Windows.Forms

Public Class Form1
   Inherits System.Windows.Forms.Form
   Private textBox1 As System.Windows.Forms.TextBox 
   
   Private Function CreateMultilevelIndentString() As String
        ' Create a TextWriter to use as the base output writer.
        Dim baseTextWriter As New System.IO.StringWriter
      
        ' Create an IndentedTextWriter and set the tab string to use 
        ' as the indentation string for each indentation level.
        Dim indentWriter = New IndentedTextWriter(baseTextWriter, "    ")

        ' Set the indentation level.
        indentWriter.Indent = 0

        ' Output test strings at stepped indentations through a recursive loop method.
        WriteLevel(indentWriter, 0, 5)
      
        ' Return the resulting string from the base StringWriter.
        Return baseTextWriter.ToString()
    End Function

    Private Sub WriteLevel(ByVal indentWriter As IndentedTextWriter, ByVal level As Integer, ByVal totalLevels As Integer)
        ' Outputs a test string with a new-line character at the end.
        indentWriter.WriteLine(("This is a test phrase. Current indentation level: " + level.ToString()))

        ' If not yet at the highest recursion level, call this output method for the next level of indentation.
        If level < totalLevels Then
            ' Increase the indentation count for the next level of indented output.
            indentWriter.Indent += 1

            ' Call the WriteLevel method to write test output for the next level of indentation.
            WriteLevel(indentWriter, level + 1, totalLevels)

            ' Restores the indentation count for this level after the recursive branch method has returned.
            indentWriter.Indent -= 1

        Else
            ' Output a string using the WriteLineNoTabs method.
            indentWriter.WriteLineNoTabs("This is a test phrase written with the IndentTextWriter.WriteLineNoTabs method.")
        End If

        ' Outputs a test string with a new-line character at the end.
        indentWriter.WriteLine(("This is a test phrase. Current indentation level: " + level.ToString()))
    End Sub

    Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        textBox1.Text = CreateMultilevelIndentString()
    End Sub

    Public Sub New()
        Dim button1 As New System.Windows.Forms.Button
        Me.textBox1 = New System.Windows.Forms.TextBox
        Me.SuspendLayout()
        Me.textBox1.Anchor = CType(System.Windows.Forms.AnchorStyles.Top Or System.Windows.Forms.AnchorStyles.Bottom Or System.Windows.Forms.AnchorStyles.Left Or System.Windows.Forms.AnchorStyles.Right, System.Windows.Forms.AnchorStyles)
        Me.textBox1.Location = New System.Drawing.Point(8, 40)
        Me.textBox1.Multiline = True
        Me.textBox1.Name = "textBox1"
        Me.textBox1.Size = New System.Drawing.Size(391, 242)
        Me.textBox1.TabIndex = 0
        Me.textBox1.Text = ""
        button1.Location = New System.Drawing.Point(11, 8)
        button1.Name = "button1"
        button1.Size = New System.Drawing.Size(229, 23)
        button1.TabIndex = 1
        button1.Text = "Generate string using IndentedTextWriter"
        AddHandler button1.Click, AddressOf Me.button1_Click
        Me.AutoScaleBaseSize = New System.Drawing.Size(5, 13)
        Me.ClientSize = New System.Drawing.Size(407, 287)
        Me.Controls.Add(button1)
        Me.Controls.Add(Me.textBox1)
        Me.Name = "Form1"
        Me.Text = "IndentedTextWriter example"
        Me.ResumeLayout(False)
    End Sub

    <STAThread()> _
    Shared Sub Main()
        Application.Run(New Form1)
    End Sub
End Class

Commenti

IndentedTextWriter estende un TextWriter fornendo metodi che inseriscono una stringa di tabulazione e tengono traccia del livello di rientro corrente. Il testo formattato con più livelli di rientro è utile per il codice generato, quindi questa classe viene usata dalle implementazioni del generatore di codice CodeDOM.

La stringa di tabulazione è la stringa di cui ogni rientro è costituito. In genere la stringa di tabulazioni contiene spazi vuoti.

Nota

Questa classe contiene una richiesta di collegamento e una richiesta di ereditarietà a livello di classe che si applica a tutti i membri. Viene generata una SecurityException quando il chiamante immediato o la classe derivata non dispone dell'autorizzazione di attendibilità totale. Per informazioni dettagliate sulle richieste di sicurezza, vedere richieste di collegamento e richieste di ereditarietà .

Costruttori

IndentedTextWriter(TextWriter)	Inizializza una nuova istanza della classe IndentedTextWriter utilizzando il writer di testo e la stringa di tabulazione predefinita specificati.
IndentedTextWriter(TextWriter, String)	Inizializza una nuova istanza della classe IndentedTextWriter utilizzando il writer di testo e la stringa di tabulazione specificati.

Campi

CoreNewLine	Archivia i caratteri di nuova riga usati per questo TextWriter. (Ereditato da TextWriter)
DefaultTabString	Specifica la stringa di tabulazioni predefinita. Questo campo è costante.

Proprietà

Encoding	Ottiene la codifica da utilizzare per il writer di testo.
FormatProvider	Ottiene un oggetto che controlla la formattazione. (Ereditato da TextWriter)
Indent	Ottiene o imposta il numero di spazi da impostare come rientro.
InnerWriter	Ottiene il TextWriter da utilizzare.
NewLine	Ottiene o imposta il nuovo carattere di riga da utilizzare.

Metodi

Close()	Chiude il documento in cui viene scritto.
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. (Ereditato da TextWriter)
Dispose(Boolean)	Rilascia le risorse non gestite usate dal TextWriter e, facoltativamente, rilascia le risorse gestite. (Ereditato da TextWriter)
DisposeAsync()	Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione asincrona delle risorse non gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Flush()	Scarica il flusso.
FlushAsync()	Cancella tutti i buffer per questo IndentedTextWriter in modo asincrono e fa in modo che tutti i dati memorizzati nel buffer vengano scritti nel dispositivo sottostante.
FlushAsync(CancellationToken)	Cancella tutti i buffer per questo IndentedTextWriter in modo asincrono e fa in modo che tutti i dati memorizzati nel buffer vengano scritti 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)
OutputTabs()	Restituisce la stringa di tabulazione una volta per ogni livello di rientro in base alla proprietà Indent.
OutputTabsAsync()	Restituisce in modo asincrono le schede al TextWriter sottostante in base all'Indentcorrente.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Write(Boolean)	Scrive la rappresentazione testuale di un valore booleano nel flusso di testo.
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. (Ereditato da TextWriter)
Write(Double)	Scrive la rappresentazione testuale di un oggetto Double nel flusso di testo.
Write(Int32)	Scrive la rappresentazione testuale di un numero intero nel flusso di testo.
Write(Int64)	Scrive la rappresentazione testuale di un intero a 8 byte nel flusso di testo.
Write(Object)	Scrive la rappresentazione testuale di un oggetto nel flusso di testo.
Write(ReadOnlySpan<Char>)	Scrive un intervallo di caratteri nel flusso di testo. (Ereditato da TextWriter)
Write(Single)	Scrive la rappresentazione testuale di un oggetto Single nel flusso di testo.
Write(String)	Scrive la stringa specificata nel flusso di testo.
Write(String, Object)	Scrive una stringa formattata usando la stessa semantica specificata.
Write(String, Object, Object)	Scrive una stringa formattata usando la stessa semantica specificata.
Write(String, Object, Object, Object)	Scrive una stringa formattata nel flusso di testo usando la stessa semantica del metodo Format(String, Object, Object, Object). (Ereditato da TextWriter)
Write(String, Object[])	Scrive una stringa formattata usando la stessa semantica specificata.
Write(String, ReadOnlySpan<Object>)	Scrive una stringa formattata nel flusso di testo usando la stessa semantica di Format(String, ReadOnlySpan<Object>). (Ereditato da TextWriter)
Write(StringBuilder)	Scrive un generatore di stringhe nel flusso di testo. (Ereditato da TextWriter)
Write(UInt32)	Scrive nel flusso di testo la rappresentazione testuale di un intero senza segno a 4 byte. (Ereditato da TextWriter)
Write(UInt64)	Scrive la rappresentazione testuale di un intero senza segno a 8 byte nel flusso di testo. (Ereditato da TextWriter)
WriteAsync(Char)	Scrive in modo asincrono il Char specificato nell'TextWritersottostante, inserendo le schede all'inizio di ogni riga.
WriteAsync(Char[])	Scrive una matrice di caratteri nel flusso di testo in modo asincrono. (Ereditato da TextWriter)
WriteAsync(Char[], Int32, Int32)	Scrive in modo asincrono il numero specificato di Chardal buffer specificato al TextWritersottostante, a partire dall'indice specificato e le schede di output all'inizio di ogni nuova riga.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Scrive in modo asincrono i caratteri specificati nell'TextWritersottostante, inserendo le schede all'inizio di ogni riga.
WriteAsync(String)	Scrive in modo asincrono la stringa specificata nella TextWritersottostante, inserendo le schede all'inizio di ogni riga.
WriteAsync(StringBuilder, CancellationToken)	Scrive in modo asincrono il contenuto del StringBuilder specificato nell'TextWritersottostante, inserendo le schede all'inizio di ogni riga.
WriteLine()	Scrive un terminatore di riga.
WriteLine(Boolean)	Scrive la rappresentazione testuale di un valore Boolean, seguito da un terminatore di riga, nel flusso di testo.
WriteLine(Char)	Scrive un carattere, seguito da un terminatore di riga, nel flusso di testo.
WriteLine(Char[])	Scrive una matrice di caratteri, seguita da un terminatore di riga, nel flusso di testo.
WriteLine(Char[], Int32, Int32)	Scrive una sottomaschera di caratteri, seguita da un terminatore di riga, nel flusso di testo.
WriteLine(Decimal)	Scrive la rappresentazione testuale di un valore decimale nel flusso di testo, seguita da un terminatore di riga. (Ereditato da TextWriter)
WriteLine(Double)	Scrive la rappresentazione testuale di un oggetto Double, seguita da un terminatore di riga, nel flusso di testo.
WriteLine(Int32)	Scrive la rappresentazione testuale di un numero intero, seguito da un terminatore di riga, nel flusso di testo.
WriteLine(Int64)	Scrive la rappresentazione testuale di un intero a 8 byte, seguita da un terminatore di riga, nel flusso di testo.
WriteLine(Object)	Scrive nel flusso di testo la rappresentazione testuale di un oggetto, seguita 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. (Ereditato da TextWriter)
WriteLine(Single)	Scrive nel flusso di testo la rappresentazione testuale di un oggetto Single, seguita da un terminatore di riga.
WriteLine(String)	Scrive la stringa specificata, seguita da un terminatore di riga, nel flusso di testo.
WriteLine(String, Object)	Scrive una stringa formattata, seguita da un terminatore di riga, usando la stessa semantica specificata.
WriteLine(String, Object, Object)	Scrive una stringa formattata, seguita da un terminatore di riga, usando la stessa semantica specificata.
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). (Ereditato da TextWriter)
WriteLine(String, Object[])	Scrive una stringa formattata, seguita da un terminatore di riga, usando la stessa semantica specificata.
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>). (Ereditato da TextWriter)
WriteLine(StringBuilder)	Scrive la rappresentazione testuale di un generatore di stringhe nel flusso di testo, seguita da un terminatore di riga. (Ereditato da TextWriter)
WriteLine(UInt32)	Scrive la rappresentazione testuale di un UInt32, seguita da un terminatore di riga, nel flusso di testo.
WriteLine(UInt64)	Scrive la rappresentazione testuale di un intero senza segno a 8 byte nel flusso di testo, seguito da un terminatore di riga. (Ereditato da TextWriter)
WriteLineAsync()	Scrive in modo asincrono il terminatore di riga nell'TextWritersottostante.
WriteLineAsync(Char)	Scrive in modo asincrono il Char specificato nel TextWriter sottostante seguito da un terminatore di riga, inserendo le schede all'inizio di ogni riga.
WriteLineAsync(Char[])	Scrive in modo asincrono una matrice di caratteri nel flusso di testo, seguita da un terminatore di riga. (Ereditato da TextWriter)
WriteLineAsync(Char[], Int32, Int32)	Scrive in modo asincrono il numero specificato di caratteri dal buffer specificato seguito da un terminatore di riga, nel TextWritersottostante, a partire dall'indice specificato all'interno del buffer, inserendo schede all'inizio di ogni riga.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Scrive in modo asincrono i caratteri specificati seguiti da un terminatore di riga nel TextWritersottostante, inserendo le schede all'inizio di ogni riga.
WriteLineAsync(String)	Scrive in modo asincrono la stringa specificata seguita da un terminatore di riga nel TextWritersottostante, inserendo schede all'inizio di ogni riga.
WriteLineAsync(StringBuilder, CancellationToken)	Scrive in modo asincrono il contenuto del StringBuilder specificato seguito da un terminatore di riga nel TextWritersottostante, inserendo le schede all'inizio di ogni riga.
WriteLineNoTabs(String)	Scrive la stringa specificata in una riga senza tabulazioni.
WriteLineNoTabsAsync(String)	Scrive in modo asincrono la stringa specificata nell'TextWriter sottostante senza inserire schede.

Metodi di estensione

ConfigureAwait(IAsyncDisposable, Boolean)

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