StreamWriter 类
实现一个 TextWriter,使其以一种特定的编码向流中写入字符。
**命名空间:**System.IO
**程序集:**mscorlib(在 mscorlib.dll 中)
语法
声明
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class StreamWriter
Inherits TextWriter
用法
Dim instance As StreamWriter
[SerializableAttribute]
[ComVisibleAttribute(true)]
public class StreamWriter : TextWriter
[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class StreamWriter : public TextWriter
/** @attribute SerializableAttribute() */
/** @attribute ComVisibleAttribute(true) */
public class StreamWriter extends TextWriter
SerializableAttribute
ComVisibleAttribute(true)
public class StreamWriter extends TextWriter
备注
StreamWriter 旨在以一种特定的编码输出字符,而从 Stream 派生的类则用于字节的输入和输出。
StreamWriter 默认使用 UTF8Encoding 的实例,除非指定了其他编码。构造 UTF8Encoding 的这个实例使得 Encoding.GetPreamble 方法返回以 UTF-8 格式编写的 Unicode 字节顺序标记。当不再向现有流中追加时,编码的报头将被添加到流中。这表示使用 StreamWriter 创建的所有文本文件都将在其开头有三个字节顺序标记。UTF-8 可以正确处理所有的 Unicode 字符并在操作系统的本地化版本上产生一致的结果。
默认情况下,StreamWriter 不是线程安全的。有关线程安全包装的信息,请参见 TextWriter.Synchronized。
下表列出了其他典型或相关的 I/O 任务的示例。
若要执行此操作... |
请参见本主题中的示例... |
---|---|
创建文本文件。 |
|
写入文本文件。 |
|
读取文本文件。 |
|
向文件中追加文本。 |
|
获取文件大小。 |
|
获取文件属性。 |
|
设置文件属性。 |
|
确定文件是否存在。 |
|
读取二进制文件。 |
|
写入二进制文件。 |
继承层次结构
System.Object
System.MarshalByRefObject
System.IO.TextWriter
System.IO.StreamWriter
线程安全
此类型的任何公共静态(Visual Basic 中的 Shared)成员都是线程安全的,但不保证所有实例成员都是线程安全的。
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、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
.NET Compact Framework
受以下版本支持:2.0、1.0
请参见
参考
StreamWriter 成员
System.IO 命名空间
Stream 类
StreamReader 类
Encoder
Encoding