StringWriter 构造函数

参考

定义

命名空间:: System.IO

程序集:: System.IO.dll

程序集:: System.Runtime.dll

程序集:: System.Runtime.Extensions.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

初始化 StringWriter 类的新实例。

重载

StringWriter()	初始化 StringWriter 类的新实例。
StringWriter(IFormatProvider)	使用指定的格式控件初始化 StringWriter 类的新实例。
StringWriter(StringBuilder)	初始化写入到指定的 StringBuilder 中的 StringWriter 类的新实例。
StringWriter(StringBuilder, IFormatProvider)	初始化 StringWriter 类的新实例，该实例写入指定 StringBuilder ，且具有指定的格式提供程序。

StringWriter()

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

初始化 StringWriter 类的新实例。

public:
 StringWriter();

public StringWriter ();

Public Sub New ()

示例

下面的代码示例演示如何使用 StringWriter 类构造字符串。

using namespace System;
using namespace System::IO;
using namespace System::Text;
int main()
{
   StringWriter^ strWriter = gcnew StringWriter;
   
   // Use the three overloads of the Write method that are 
   // overridden by the StringWriter class.
   strWriter->Write( "file path characters are: " );
   strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
   strWriter->Write( Char::Parse( "." ) );
   
   // Use the underlying StringBuilder for more complex 
   // manipulations of the string.
   strWriter->GetStringBuilder()->Insert( 0, "Invalid " );
   
   Console::WriteLine( "The following string is {0} encoded.\n{1}", strWriter->Encoding->EncodingName, strWriter->ToString() );
   
}

using System;
using System.IO;
using System.Text;

class StrWriter
{
    static void Main()
    {
        StringWriter strWriter  = new StringWriter();

        // Use the three overloads of the Write method that are
        // overridden by the StringWriter class.
        strWriter.Write("file path characters are: ");
        strWriter.Write(
            Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);
        strWriter.Write('.');

        // Use the underlying StringBuilder for more complex
        // manipulations of the string.
        strWriter.GetStringBuilder().Insert(0, "Invalid ");

        Console.WriteLine("The following string is {0} encoded.\n{1}",
            strWriter.Encoding.EncodingName, strWriter.ToString());
    }
}

Imports System.IO
Imports System.Text

Public Class StrWriter

    Shared Sub Main()

        Dim strWriter As StringWriter = new StringWriter()

        ' Use the three overloads of the Write method that are 
        ' overridden by the StringWriter class.
        strWriter.Write("file path characters are: ")
        strWriter.Write( _
            Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)
        strWriter.Write("."C)

        ' Use the underlying StringBuilder for more complex 
        ' manipulations of the string.
        strWriter.GetStringBuilder().Insert(0, "Invalid ")

        Console.WriteLine("The following string is {0} encoded." _
            & vbCrLf & "{1}", _
            strWriter.Encoding.EncodingName, strWriter.ToString())

    End Sub
End Class

注解

将自动创建一个新的 StringBuilder 对象，并将其与类的新实例 StringWriter 相关联。由于未为此构造函数指定格式控件，因此将使用初始化 CultureInfo.CurrentCulture新实例。

下表列出了其他典型或相关 I/O 任务的示例。

若要执行此操作...	请参见本主题中的示例...
创建文本文件。	如何：将文本写入文件
写入文本文件。	如何：将文本写入文件
从文本文件读取。	如何：从文件中读取文本
将文本追加到文件。	如何：打开并追加到日志文件 File.AppendText FileInfo.AppendText
获取文件的大小。	FileInfo.Length
获取文件的属性。	File.GetAttributes
设置文件的属性。	File.SetAttributes
确定文件是否存在。	File.Exists
从二进制文件读取。	如何：对新建的数据文件进行读取和写入
写入二进制文件。	如何：对新建的数据文件进行读取和写入

另请参阅

适用于

StringWriter(IFormatProvider)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

使用指定的格式控件初始化 StringWriter 类的新实例。

public:
 StringWriter(IFormatProvider ^ formatProvider);

public StringWriter (IFormatProvider formatProvider);

public StringWriter (IFormatProvider? formatProvider);

new System.IO.StringWriter : IFormatProvider -> System.IO.StringWriter

Public Sub New (formatProvider As IFormatProvider)

参数

formatProvider: IFormatProvider

控制格式设置的 IFormatProvider 对象。

示例

下面的代码示例演示如何构造特定区域性中的字符串。

using namespace System;
using namespace System::Globalization;
using namespace System::IO;
int main()
{
   StringWriter^ strWriter = gcnew StringWriter( gcnew CultureInfo(  "ar-DZ" ) );
   strWriter->Write( DateTime::Now );
   
   Console::WriteLine( "Current date and time using the invariant culture: {0}\n"
   "Current date and time using the Algerian culture: {1}", DateTime::Now.ToString(), strWriter->ToString() );
   
}

using System;
using System.Globalization;
using System.IO;

class StrWriter
{
    static void Main()
    {
        StringWriter strWriter =
            new StringWriter(new CultureInfo("ar-DZ"));

        strWriter.Write(DateTime.Now);

        Console.WriteLine(
            "Current date and time using the invariant culture: {0}\n" +
            "Current date and time using the Algerian culture: {1}",
            DateTime.Now.ToString(), strWriter.ToString());
    }
}

Imports System.Globalization
Imports System.IO

Public Class StrWriter

    Shared Sub Main()
        Dim strWriter As New StringWriter(New CultureInfo("ar-DZ"))

        strWriter.Write(DateTime.Now)

        Console.WriteLine( _
            "Current date and time using the invariant culture: {0}" _
            & vbCrLf & _
            "Current date and time using the Algerian culture: {1}", _
            DateTime.Now.ToString(), strWriter.ToString())
    End Sub

End Class

注解

将自动创建一个新的 StringBuilder 对象，并将其与类的新实例 StringWriter 相关联。

下表列出了其他典型或相关 I/O 任务的示例。

若要执行此操作...	请参见本主题中的示例...
创建文本文件。	如何：将文本写入文件
写入文本文件。	如何：将文本写入文件
从文本文件读取。	如何：从文件中读取文本
将文本追加到文件。	如何：打开并追加到日志文件 File.AppendText FileInfo.AppendText
获取文件的大小。	FileInfo.Length
获取文件的属性。	File.GetAttributes
设置文件的属性。	File.SetAttributes
确定文件是否存在。	File.Exists
从二进制文件读取。	如何：对新建的数据文件进行读取和写入
写入二进制文件。	如何：对新建的数据文件进行读取和写入

另请参阅

适用于

StringWriter(StringBuilder)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

初始化写入到指定的 StringBuilder 中的 StringWriter 类的新实例。

public:
 StringWriter(System::Text::StringBuilder ^ sb);

public StringWriter (System.Text.StringBuilder sb);

new System.IO.StringWriter : System.Text.StringBuilder -> System.IO.StringWriter

Public Sub New (sb As StringBuilder)

参数

sb: StringBuilder

要写入的 StringBuilder 对象。

例外

ArgumentNullException

sb 为 null。

示例

下面的代码示例演示如何使用 StringBuilder 类修改闭合 StringWriter中的基础字符串。

using namespace System;
using namespace System::IO;
using namespace System::Text;
int main()
{
   StringBuilder^ strBuilder = gcnew StringBuilder( "file path characters are: " );
   StringWriter^ strWriter = gcnew StringWriter( strBuilder );
   strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
   
   strWriter->Close();
   
   // Since the StringWriter is closed, an exception will 
   // be thrown if the Write method is called. However, 
   // the StringBuilder can still manipulate the string.
   strBuilder->Insert( 0, "Invalid " );
   Console::WriteLine( strWriter->ToString() );
   
}

using System;
using System.IO;
using System.Text;

class StrWriter
{
    static void Main()
    {
        StringBuilder strBuilder =
            new StringBuilder("file path characters are: ");
        StringWriter strWriter = new StringWriter(strBuilder);

        strWriter.Write(
            Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);

        strWriter.Close();

        // Since the StringWriter is closed, an exception will
        // be thrown if the Write method is called. However,
        // the StringBuilder can still manipulate the string.
        strBuilder.Insert(0, "Invalid ");
        Console.WriteLine(strWriter.ToString());
    }
}

Imports System.IO
Imports System.Text

Public Class StrWriter

    Shared Sub Main()
        Dim strBuilder As New StringBuilder( _
            "file path characters are: ")
        Dim strWriter As New StringWriter(strBuilder)

        strWriter.Write( _
            Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)

        strWriter.Close()

        ' Since the StringWriter is closed, an exception will 
        ' be thrown if the Write method is called. However, 
        ' the StringBuilder can still manipulate the string.
        strBuilder.Insert(0, "Invalid ")
        Console.WriteLine(strWriter.ToString())
    End Sub

End Class

注解

由于未为此构造函数指定格式控件，因此将使用初始化 CultureInfo.CurrentCulture新实例。

下表列出了其他典型或相关 I/O 任务的示例。

若要执行此操作...	请参见本主题中的示例...
创建文本文件。	如何：将文本写入文件
写入文本文件。	如何：将文本写入文件
从文本文件读取。	如何：从文件中读取文本
将文本追加到文件。	如何：打开并追加到日志文件 File.AppendText FileInfo.AppendText
获取文件的大小。	FileInfo.Length
获取文件的属性。	File.GetAttributes
设置文件的属性。	File.SetAttributes
确定文件是否存在。	File.Exists
从二进制文件读取。	如何：对新建的数据文件进行读取和写入
写入二进制文件。	如何：对新建的数据文件进行读取和写入

另请参阅

适用于

StringWriter(StringBuilder, IFormatProvider)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

初始化 StringWriter 类的新实例，该实例写入指定 StringBuilder ，且具有指定的格式提供程序。

public:
 StringWriter(System::Text::StringBuilder ^ sb, IFormatProvider ^ formatProvider);

public StringWriter (System.Text.StringBuilder sb, IFormatProvider formatProvider);

public StringWriter (System.Text.StringBuilder sb, IFormatProvider? formatProvider);

new System.IO.StringWriter : System.Text.StringBuilder * IFormatProvider -> System.IO.StringWriter

Public Sub New (sb As StringBuilder, formatProvider As IFormatProvider)

参数

sb: StringBuilder

要写入的 StringBuilder 对象。

formatProvider: IFormatProvider

控制格式设置的 IFormatProvider 对象。

例外

ArgumentNullException

sb 为 null。

注解

下表列出了其他典型或相关 I/O 任务的示例。

若要执行此操作...	请参见本主题中的示例...
创建文本文件。	如何：将文本写入文件
写入文本文件。	如何：将文本写入文件
从文本文件读取。	如何：从文件中读取文本
将文本追加到文件。	如何：打开并追加到日志文件 File.AppendText FileInfo.AppendText
获取文件的大小。	FileInfo.Length
获取文件的属性。	File.GetAttributes
设置文件的属性。	File.SetAttributes
确定文件是否存在。	File.Exists
从二进制文件读取。	如何：对新建的数据文件进行读取和写入
写入二进制文件。	如何：对新建的数据文件进行读取和写入

另请参阅

适用于

通过

StringWriter 构造函数

定义

重载

StringWriter()

示例

注解

另请参阅

适用于

StringWriter(IFormatProvider)

参数

示例

注解

另请参阅

适用于

StringWriter(StringBuilder)

参数

例外

示例

注解

另请参阅

适用于

StringWriter(StringBuilder, IFormatProvider)

参数

例外

注解

另请参阅

适用于

其他资源