StreamWriter 类

定义

public ref class StreamWriter : System::IO::TextWriter

public class StreamWriter : System.IO.TextWriter

[System.Serializable]
public class StreamWriter : System.IO.TextWriter

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StreamWriter : System.IO.TextWriter

type StreamWriter = class
    inherit TextWriter

[<System.Serializable>]
type StreamWriter = class
    inherit TextWriter

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StreamWriter = class
    inherit TextWriter

Public Class StreamWriter
Inherits TextWriter

继承

Object

TextWriter

StreamWriter

继承

Object

MarshalByRefObject

TextWriter

StreamWriter

属性

SerializableAttribute ComVisibleAttribute

示例

以下示例演示如何使用 StreamWriter 对象编写列出 C 驱动器上的目录的文件，然后使用 StreamReader 对象读取和显示每个目录名称。 最佳做法是在 using 语句中使用这些对象，以便正确释放非托管资源。 using 语句在使用该语句的代码已完成时自动调用对象 Dispose。 此示例中使用的构造函数不支持在 Windows 应用商店应用中使用。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;

namespace StreamReadWrite
{
    class Program
    {
        static void Main(string[] args)
        {
            // Get the directories currently on the C drive.
            DirectoryInfo[] cDirs = new DirectoryInfo(@"c:\").GetDirectories();

            // Write each directory name to a file.
            using (StreamWriter sw = new StreamWriter("CDriveDirs.txt"))
            {
                foreach (DirectoryInfo dir in cDirs)
                {
                    sw.WriteLine(dir.Name);
                }
            }

            // Read and show each line from the file.
            string line = "";
            using (StreamReader sr = new StreamReader("CDriveDirs.txt"))
            {
                while ((line = sr.ReadLine()) != null)
                {
                    Console.WriteLine(line);
                }
            }
        }
    }
}

Imports System.IO
Class Program

    Shared Sub Main()

        ' Get the directories currently on the C drive.
        Dim cDirs As DirectoryInfo() = New DirectoryInfo("c:\").GetDirectories()

        ' Write each directory name to a file.
        Using sw As StreamWriter = New StreamWriter("CDriveDirs.txt")
            For Each Dir As DirectoryInfo In cDirs
                sw.WriteLine(Dir.Name)
            Next
        End Using

        'Read and show each line from the file.
        Dim line As String = ""
        Using sr As StreamReader = New StreamReader("CDriveDirs.txt")
            Do
                line = sr.ReadLine()
                Console.WriteLine(line)
            Loop Until line Is Nothing
        End Using


    End Sub

End Class

注解

StreamWriter 专用于特定编码中的字符输出，而派生自 Stream 的类专为字节输入和输出而设计。

除非另有指定，否则 StreamWriter 默认使用 UTF8Encoding 实例。 此 UTF8Encoding 实例在没有字节顺序标记（BOM）的情况下构造，因此其 GetPreamble 方法返回空字节数组。 此构造函数的默认 UTF-8 编码对无效字节引发异常。 此行为与 Encoding.UTF8 属性中的编码对象提供的行为不同。 若要指定 BOM 并确定是否对无效字节引发异常，请使用接受编码对象的构造函数作为参数，例如 StreamWriter(String, Boolean, Encoding) 或 StreamWriter。

默认情况下，StreamWriter 不是线程安全的。 有关线程安全的包装器，请参阅 TextWriter.Synchronized。

有关常见 I/O 任务的列表，请参阅 常见 I/O 任务。

构造函数

字段

属性

方法

显式接口实现

扩展方法

适用于

另请参阅

• Stream
• StreamReader
• Encoder
• Encoding
• 文件和流 I/O
• 如何：从文件读取文本
• 如何：将文本写入文件
• 如何：读取和写入新创建的数据文件