C#中流写入类StreamWriter的介绍 (转)

应用FileStream类需要许多额外的数据类型转换工作，十分影响效率。使用StreamWriter类将提供更简单，更方便的操作方式。
   StreamWriter类允许直接将字符和字符串写入文件，一般不针对二进制数据。
类的结构：
public class StreamWriter:TextWriter ：实现一个TextWriter，使其以一种特定的编码向流中写入字符。 StreamWriter旨在以一种特定的编码(默认使用UTF8Encoding)输出字符。
构建器：
public StreamWriter (Stream stream)：用UTF-8编码及默认缓冲区大小，为指定的流初始化StreamWriter类的一个新实例。 参数stream(可用FileStream类实例代替)要写入的流。 --可利用FileStream更好的控制对文件的操作方式。
public StreamWriter ( string path )：使用默认编码和缓冲区大小，为指定路径上的指定文件初始化 StreamWriter类的新实例。参数path要向其中写入的完整文件路径。path 可以是文件名。
public StreamWriter ( Stream stream, Encoding encoding )：用指定的编码及默认缓冲区大小，为指定的流初始化StreamWriter类的新实例。参数encoding指定要使用的字符编码。


public StreamWriter ( string path, bool append )：使用默认编码和缓冲区大小，为指定路径上的指定文件初始化StreamWriter类的新实例。如果该文件存在，则可以将其改写或向其追加。如果该文件不存在，则此构造函数将创建一个新文件。参数 path 指定要写入的完整文件路径。 append指定确定是否将数据追加到文件。如果该文件存在，并且 append 为 false，则该文件被改写。如果该文件存在，并且 append 为 true，则数据被追加到该文件中。否则，将创建新文件。 
属性
public virtual bool AutoFlush { get; set; }：获取或设置一个值，该值指示 StreamWriter 是否在每次调用 StreamWriter.Write之后，将其缓冲区刷新到基础流。 此属性值强制 StreamWriter 刷新其缓冲区时，为 true；否则，为 false。 
public virtual string NewLine { get; set; }：获取或设置由当前 TextWriter 使用的行结束符字符串。 默认行结束符字符串是回车符后接一个换行符（“\r\n”）。
方法：
public override void Close ()：关闭当前的 StreamWriter 对象和基础流。 
public override void Flush ()：清理当前编写器的所有缓冲区，并使所有缓冲数据写入基础流。 注意：在写出数据后，必须使用此方法将缓冲中的数据写出到流对应的目标中。
public override void Write(string value)：将字符串写入流，参数value 要写入流的字符串。如果value为空，则不写入任何内容。 
public virtual void Write ( string format, params Object[] arg )：使用与 String.Format 相同的语义写出格式化的字符串。参数format格式化字符串。 Arg指定要写入格式化字符串的对象数组。 
public virtual void WriteLine ()：将行结束符写入文本流。默认行结束符是后跟换行符的回车符（“\r\n”），但使用 NewLine 属性可以更改此值。
public virtual void WriteLine ( string value )：将后跟行结束符的字符串写入文本流。 参数value指定要写入的字符串。如果 value 为 空引用（在 Visual Basic 中为 Nothing），则仅写入行结束字符。
public virtual void WriteLine ( string format, params Object[] arg )：使用与 Format 相同的语义写出格式化的字符串和一个新行。参数format 格式化字符串。 Arg指定要写入格式化字符串的对象数组。 
范例：
using System;
using System.IO;
using System.Text;
class TestRW
{
    public static void Main(String[] args)
    {
        if (File.Exists(@"c:\MyFile.txt"))
        {
            using (FileStream fs = new FileStream(@"c:\MyFile.txt", FileMode.Append, FileAccess.Write))
            {
                fs.Lock(0, fs.Length);
                StreamWriter sw = new StreamWriter(fs);
                sw.WriteLine("我是最好的，虽然现在不是");
                sw.WriteLine("有信息，不一定会赢，但没有信心，肯定会输");
                sw.WriteLine("我的期待月薪为{0,9:C4},实现年龄为{1,9},成功率{2,9:P2}", new Object[] { 20000, 30, 1 });
                fs.Unlock(0, fs.Length);//一定要用在Flush()方法以前，否则抛出异常。
                sw.Flush();
            }
        }
        else
        {
            Console.WriteLine("文件不存在");
        }
    }
}

C#中流写入类StreamWriter的介绍