IndentedTextWriter Třída

Definice

Obor názvů:

System.CodeDom.Compiler

Sestavení:

System.Runtime.dll

Zdroj:

IndentedTextWriter.cs

Poskytuje textový zapisovač, který může odsadit nové řádky pomocí tokenu řetězce tabulátoru.

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

public class IndentedTextWriter : System.IO.TextWriter

type IndentedTextWriter = class
    inherit TextWriter

Public Class IndentedTextWriter
Inherits TextWriter

Dědičnost

Object

MarshalByRefObject

TextWriter

IndentedTextWriter

Příklady

Následující příklad kódu ukazuje použití IndentedTextWriter k zápisu textu na různých úrovních odsazení.

#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

Poznámky

IndentedTextWriter rozšiřuje TextWriter tím, že poskytuje metody, které vloží řetězec tabulátoru a sledují aktuální úroveň odsazení. Text formátovaný s více úrovněmi odsazení je užitečný pro vygenerovaný kód, takže tato třída je používána implementacemi generátoru kódu CodeDOM.

Řetězec tabulátoru je řetězec, ze kterého se skládá každé odsazení. Řetězec tabulátoru obvykle obsahuje prázdné znaky.

Poznámka

Tato třída obsahuje požadavek na propojení a poptávku dědičnosti na úrovni třídy, která se vztahuje na všechny členy. SecurityException je vyvolán, pokud buď bezprostřední volající, nebo odvozená třída nemá oprávnění k úplnému důvěryhodnosti. Podrobnosti o požadavcích na zabezpečení najdete v tématu Požadavky na propojení a požadavky na dědičnost .

Konstruktory

IndentedTextWriter(TextWriter)	Inicializuje novou instanci třídy IndentedTextWriter pomocí zadaného textového zapisovače a výchozího řetězce tabulátoru.
IndentedTextWriter(TextWriter, String)	Inicializuje novou instanci třídy IndentedTextWriter pomocí zadaného textového zapisovače a řetězce tabulátoru.

Pole

CoreNewLine	Ukládá znaky nového řádku použité pro tento TextWriter. (Zděděno od TextWriter)
DefaultTabString	Určuje výchozí řetězec tabulátoru. Toto pole je konstantní.

Vlastnosti

Encoding	Získá kódování pro textového zapisovače, který se má použít.
FormatProvider	Získá objekt, který řídí formátování. (Zděděno od TextWriter)
Indent	Získá nebo nastaví počet mezer pro odsazení.
InnerWriter	Získá TextWriter použít.
NewLine	Získá nebo nastaví nový znak řádku, který se má použít.

Metody

Close()	Zavře dokument, do kterého se zapisuje.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané objektem TextWriter. (Zděděno od TextWriter)
Dispose(Boolean)	Uvolní nespravované prostředky používané TextWriter a volitelně uvolní spravované prostředky. (Zděděno od TextWriter)
DisposeAsync()	Provádí úlohy definované aplikací přidružené k uvolnění, uvolnění nebo resetování nespravovaných prostředků asynchronně.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Flush()	Vyprázdní stream.
FlushAsync()	Vymaže všechny vyrovnávací paměti pro tuto IndentedTextWriter asynchronně a způsobí zápis všech dat uložených do vyrovnávací paměti do podkladového zařízení.
FlushAsync(CancellationToken)	Vymaže všechny vyrovnávací paměti pro tuto IndentedTextWriter asynchronně a způsobí zápis všech dat uložených do vyrovnávací paměti do podkladového zařízení.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního objektu MarshalByRefObject. (Zděděno od MarshalByRefObject)
OutputTabs()	Vypíše řetězec tabulátoru jednou pro každou úroveň odsazení podle vlastnosti Indent.
OutputTabsAsync()	Asynchronně vypíše karty do podkladového TextWriter na základě aktuálního Indent.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Write(Boolean)	Zapíše textovou reprezentaci logické hodnoty do textového streamu.
Write(Char)	Zapíše znak do textového streamu.
Write(Char[])	Zapíše pole znaků do textového streamu.
Write(Char[], Int32, Int32)	Zapíše dílčí pole znaků do textového streamu.
Write(Decimal)	Zapíše textovou reprezentaci desetinné hodnoty do textového streamu. (Zděděno od TextWriter)
Write(Double)	Zapíše textovou reprezentaci double do textového streamu.
Write(Int32)	Zapíše textovou reprezentaci celého čísla do textového streamu.
Write(Int64)	Zapíše textovou reprezentaci 8 bajtového celého čísla do textového streamu.
Write(Object)	Zapíše textovou reprezentaci objektu do textového streamu.
Write(ReadOnlySpan<Char>)	Zapíše rozsah znaků do textového streamu. (Zděděno od TextWriter)
Write(Single)	Zapíše textovou reprezentaci jednoho do textového streamu.
Write(String)	Zapíše zadaný řetězec do textového streamu.
Write(String, Object)	Zapíše formátovaný řetězec se stejnou sémantikou, jakou jste zadali.
Write(String, Object, Object)	Zapíše formátovaný řetězec se stejnou sémantikou, jakou jste zadali.
Write(String, Object, Object, Object)	Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object, Object, Object) metoda. (Zděděno od TextWriter)
Write(String, Object[])	Zapíše formátovaný řetězec se stejnou sémantikou, jakou jste zadali.
Write(String, ReadOnlySpan<Object>)	Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, ReadOnlySpan<Object>). (Zděděno od TextWriter)
Write(StringBuilder)	Zapíše tvůrce řetězců do textového streamu. (Zděděno od TextWriter)
Write(UInt32)	Zapíše textovou reprezentaci 4bajtů bez znaménka do textového streamu. (Zděděno od TextWriter)
Write(UInt64)	Zapíše textovou reprezentaci 8bajtů bez znaménka do textového streamu. (Zděděno od TextWriter)
WriteAsync(Char)	Asynchronně zapíše zadanou Char do podkladové TextWriter, vkládání tabulátorů na začátek každého řádku.
WriteAsync(Char[])	Zapíše pole znaků do textového streamu asynchronně. (Zděděno od TextWriter)
WriteAsync(Char[], Int32, Int32)	Asynchronně zapíše zadaný počet Chars ze zadané vyrovnávací paměti do podkladové TextWriter, počínaje zadaným indexem a výstupem karet na začátku každého nového řádku.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Asynchronně zapisuje zadané znaky do podkladového TextWriter, vkládání tabulátorů na začátek každého řádku.
WriteAsync(String)	Asynchronně zapíše zadaný řetězec do podkladového TextWriter, vkládání tabulátorů na začátek každého řádku.
WriteAsync(StringBuilder, CancellationToken)	Asynchronně zapisuje obsah zadaného StringBuilder do podkladového TextWriter, vkládání tabulátorů na začátek každého řádku.
WriteLine()	Zapíše ukončovací znak řádku.
WriteLine(Boolean)	Zapíše textovou reprezentaci logické hodnoty následované ukončovacím znakem řádku do textového streamu.
WriteLine(Char)	Zapíše znak následovaný ukončovacím znakem řádku do textového streamu.
WriteLine(Char[])	Zapíše do textového streamu znakovou matici následovanou ukončovacím znakem.
WriteLine(Char[], Int32, Int32)	Zapíše dílčí pole znaků následovaných ukončovacím znakem řádku do textového streamu.
WriteLine(Decimal)	Zapíše textovou reprezentaci desetinné hodnoty do textového datového proudu následovanou ukončovacím řádkem. (Zděděno od TextWriter)
WriteLine(Double)	Zapíše textovou reprezentaci dvojitého znaku následovanou ukončovacím znakem řádku do textového streamu.
WriteLine(Int32)	Zapíše textovou reprezentaci celého čísla následovaného ukončovacím řádkem do textového streamu.
WriteLine(Int64)	Zapíše textovou reprezentaci 8 bajtového celého čísla následovaného ukončovacím řádkem do textového streamu.
WriteLine(Object)	Zapíše textovou reprezentaci objektu následovaného ukončovacím znakem řádku do textového streamu.
WriteLine(ReadOnlySpan<Char>)	Zapíše textovou reprezentaci rozsahu znaků do textového streamu následovaného ukončovacím řádkem. (Zděděno od TextWriter)
WriteLine(Single)	Zapíše textovou reprezentaci jednoho, za kterým následuje ukončovací znak řádku, do textového streamu.
WriteLine(String)	Zapíše zadaný řetězec následovaný ukončovacím řádkem do textového streamu.
WriteLine(String, Object)	Zapíše formátovaný řetězec následovaný ukončovacím znakem řádku pomocí stejné sémantiky, jakou jste zadali.
WriteLine(String, Object, Object)	Zapíše formátovaný řetězec následovaný ukončovacím znakem řádku pomocí stejné sémantiky, jakou jste zadali.
WriteLine(String, Object, Object, Object)	Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako Format(String, Object). (Zděděno od TextWriter)
WriteLine(String, Object[])	Zapíše formátovaný řetězec následovaný ukončovacím znakem řádku pomocí stejné sémantiky, jakou jste zadali.
WriteLine(String, ReadOnlySpan<Object>)	Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako Format(String, ReadOnlySpan<Object>). (Zděděno od TextWriter)
WriteLine(StringBuilder)	Zapíše textovou reprezentaci tvůrce řetězců do textového streamu následovaného ukončovacím řádkem. (Zděděno od TextWriter)
WriteLine(UInt32)	Zapíše textovou reprezentaci UInt32 následovanou ukončovacím znakem řádku do textového streamu.
WriteLine(UInt64)	Zapíše textovou reprezentaci 8bajtů bez znaménka do textového datového proudu následovaného ukončovacím znakem řádku. (Zděděno od TextWriter)
WriteLineAsync()	Asynchronně zapíše ukončovací znak řádku do podkladové TextWriter.
WriteLineAsync(Char)	Asynchronně zapíše zadanou Char do podkladové TextWriter následované ukončovacím znakem řádku a vloží tabulátory na začátek každého řádku.
WriteLineAsync(Char[])	Asynchronně zapíše pole znaků do textového datového proudu následovaného ukončovacím řádkem. (Zděděno od TextWriter)
WriteLineAsync(Char[], Int32, Int32)	Asynchronně zapíše zadaný počet znaků ze zadané vyrovnávací paměti následované ukončovacím znakem řádku do podkladového TextWriter, počínaje zadaným indexem v rámci vyrovnávací paměti, vkládání tabulátoru na začátek každého řádku.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Asynchronně zapisuje zadané znaky následované ukončovacím znakem řádku do podkladové TextWriter, vkládání tabulátoru na začátek každého řádku.
WriteLineAsync(String)	Asynchronně zapíše zadaný řetězec následovaný ukončovacím znakem řádku do podkladového TextWriter, vložení tabulátoru na začátek každého řádku.
WriteLineAsync(StringBuilder, CancellationToken)	Asynchronně zapisuje obsah zadaného StringBuilder následovaný ukončovacím znakem na podkladovou TextWriter, vkládání tabulátoru na začátek každého řádku.
WriteLineNoTabs(String)	Zapíše zadaný řetězec na řádek bez tabulátoru.
WriteLineNoTabsAsync(String)	Asynchronně zapíše zadaný řetězec do podkladového TextWriter bez vložení tabulátoru.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.