StringWriter 构造函数 
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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.StringWriterPublic 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.StringWriterPublic Sub New (sb As StringBuilder)参数
要写入的 StringBuilder 对象。
例外
              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.StringWriterPublic Sub New (sb As StringBuilder, formatProvider As IFormatProvider)参数
要写入的 StringBuilder 对象。
- formatProvider
- IFormatProvider
控制格式设置的 IFormatProvider 对象。
例外
              sb 为 null。
注解
下表列出了其他典型或相关 I/O 任务的示例。
| 若要执行此操作... | 请参见本主题中的示例... | 
|---|---|
| 创建文本文件。 | 如何:将文本写入文件 | 
| 写入文本文件。 | 如何:将文本写入文件 | 
| 从文本文件读取。 | 如何:从文件中读取文本 | 
| 将文本追加到文件。 | 如何:打开并追加到日志文件 File.AppendText FileInfo.AppendText | 
| 获取文件的大小。 | FileInfo.Length | 
| 获取文件的属性。 | File.GetAttributes | 
| 设置文件的属性。 | File.SetAttributes | 
| 确定文件是否存在。 | File.Exists | 
| 从二进制文件读取。 | 如何:对新建的数据文件进行读取和写入 | 
| 写入二进制文件。 | 如何:对新建的数据文件进行读取和写入 |