IndentedTextWriter 类
提供可根据 Tab 字符串标记缩进新行的文本编写器。
**命名空间:**System.CodeDom.Compiler
**程序集:**System（在 system.dll 中）
语法
声明
Public Class IndentedTextWriter
Inherits TextWriter
用法
Dim instance As IndentedTextWriter
public class IndentedTextWriter : TextWriter
public ref class IndentedTextWriter : public TextWriter
public class IndentedTextWriter extends TextWriter
public class IndentedTextWriter extends TextWriter
备注
IndentedTextWriter 通过提供插入 Tab 字符串和跟踪当前缩进级别的方法来扩展 TextWriter。用多个缩进级别格式化的文本对生成的代码很有用，因此此类由 CodeDOM 代码生成器实现使用。
Tab 字符串是指每个缩进包含的字符串。Tab 字符串通常包含空白。
提示
此类在类级别上包含一个链接要求和一个继承要求，两个要求应用于所有成员。如果直接调用方或派生类不具有完全信任权限，则会引发 SecurityException。有关安全要求的详细信息，请参见 链接要求 和 继承要求。
示例
下面的代码示例阐释了如何使用 IndentedTextWriter 以不同的缩进级别编写文本。
Imports System
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
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());
}
}
}
#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 );
}
package IndentedTextWriterExample;
import System.*;
import System.CodeDom.*;
import System.CodeDom.Compiler.*;
import System.ComponentModel.*;
import System.IO.*;
import System.Windows.Forms.*;
public class Form1 extends 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.set_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();
} //CreateMultilevelIndentString
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: "
+ System.Convert.ToString(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.set_Indent(indentWriter.get_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.set_Indent(indentWriter.get_Indent() - 1);
}
// Outputs a string using the WriteLineNoTabs method.
else {
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: "
+ System.Convert.ToString(level));
} //WriteLevel
private void button1_Click(Object sender, System.EventArgs e)
{
textBox1.set_Text(CreateMultilevelIndentString());
} //button1_Click
public Form1()
{
System.Windows.Forms.Button button1 = new System.Windows.Forms.Button();
this.textBox1 = new System.Windows.Forms.TextBox();
this.SuspendLayout();
this.textBox1.set_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.set_Location(new System.Drawing.Point(8, 40));
this.textBox1.set_Multiline(true);
this.textBox1.set_Name("textBox1");
this.textBox1.set_Size(new System.Drawing.Size(391, 242));
this.textBox1.set_TabIndex(0);
this.textBox1.set_Text("");
button1.set_Location(new System.Drawing.Point(11, 8));
button1.set_Name("button1");
button1.set_Size(new System.Drawing.Size(229, 23));
button1.set_TabIndex(1);
button1.set_Text("Generate string using IndentedTextWriter");
button1.add_Click(new System.EventHandler(this.button1_Click));
this.set_AutoScaleBaseSize(new System.Drawing.Size(5, 13));
this.set_ClientSize(new System.Drawing.Size(407, 287));
this.get_Controls().Add(button1);
this.get_Controls().Add(this.textBox1);
this.set_Name("Form1");
this.set_Text("IndentedTextWriter example");
this.ResumeLayout(false);
} //Form1
/** @attribute STAThread()
*/
public static void main(String[] args)
{
Application.Run(new Form1());
} //main
} //Form1
.NET Framework 安全性
- SecurityPermission 用于调用 IndentedTextWriter 的成员。要求值：LinkDemand；命名的权限集：FullTrust。
- SecurityPermission 用于从 IndentedTextWriter 类派生。要求值：InheritanceDemand；命名的权限集：FullTrust。
继承层次结构
System.Object
System.MarshalByRefObject
System.IO.TextWriter
System.CodeDom.Compiler.IndentedTextWriter
线程安全
此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。
平台
Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0