在介绍StreamWriter之前,我们首先来了解一下它的父类TextWriter。
一、TextWriter
1、TextWriter的构造函数和常用属性方法
下面是TextWriter的构造函数:
和所有抽象类一样,该类不能直接实例化,它有两个构造函数。
特别说一下第二个构造函数,大家发现这个构造函数中有一个类型IFomatProvider类型的参数,这个是什么东东呢?
IFomatProvider接口的简单介绍
其实,IFomatProvider接口从字面上就能理解了,一个格式化的提供者。大家记得我们常用的string.Format("{0:P}",data);么?IFomatProvider在这里被隐式调用了。
关于隐式调用的各种方式,用个简单的例子向大家说明一下:
//有关数字格式化隐性使用IFomatProvider的例子 #if true //货币 //十进制 Console.WriteLine("显示货币十进制格式{0:d10}", 12); //科学计数法 Console.WriteLine("科学计数法{0:e5}",12); //固定点格式 Console.WriteLine("固定点格式 {0:f10}",12);1 //常规格式 Console.WriteLine("常规格式{0:g10}",12); //数字格式(用分号隔开) Console.WriteLine("数字格式 {0:n5}:",666666666); //百分号格式 Console.WriteLine("百分号格式(不保留小数){0:p0}",0.55); //16进制 Console.WriteLine("16进制{0:x0}", 12); // 0定位器 此示例保留5位小数,如果小数部分小于5位,用0填充 Console.WriteLine("0定位器{0:000.00000}",1222.133); //数字定位器 Console.WriteLine("数字定位器{0:(#).###}", 0200.0233000); //小数 Console.WriteLine("小数保留一位{0:0.0}", 12.222); //百分号的另一种写法,注意小数的四舍五入 Console.WriteLine("百分号的另一种写法,注意小数的四舍五入{0:0%.00}", 0.12345); Console.WriteLine("\n\n"); #endif
输出结果:
也就是说IFomatProvider提供了一个格式化的工具,让我们通过NumberFomatInfo类来了解一下
这个密封类实现了IFomatProvider接口,主要实现了一个数字格式化的类,下面是一些规定的格式化说明符:
让我们用简单易懂的代码来实现NumberFomatInfo如何使用:
#if true //显性使用IFomatProvider Console.WriteLine("显性使用IFomatProvider的例子"); //实例化numberFomatProvider对象 NumberFormatInfo numberFomatProvider = new NumberFormatInfo(); //设置该provider对于货币小数的显示长度 numberFomatProvider.CurrencyDecimalDigits = 10; //注意:我们可以使用C+数字形式来改变provider提供的格式 Console.WriteLine(string.Format(numberFomatProvider, "provider设置的货币格式{0:C}", 12)); Console.WriteLine(string.Format(numberFomatProvider, "provider设置的货币格式被更改了:{0:C2}", 12)); Console.WriteLine(string.Format(numberFomatProvider, "默认百分号和小数形式{0:p2}", 0.12)); //将小数 “.”换成"?" numberFomatProvider.PercentDecimalSeparator = "?"; Console.WriteLine(string.Format(numberFomatProvider, "provider设置的百分号和小数形式{0:p2}", 0.12)); Console.ReadLine(); #endif
输出结果:
正如上述代码表示的,IFormatProvider提供用于检索控制格式化的对象的机制,我们甚至可以自定义Provider类来实现特殊的字符串格式化,关于这个重要的知识点,我会在另外一篇博文中详细介绍并自定义一个简单的FomatInfo类。
言归正传,让我们了解一下TextWriter的几个重要属性
TextWriter重要属性:
(1)、Encoding:可以获得当前TextWriter的Encoding
(2)、FomatProvider:可以获得当前TextWriter的FomatProvider
(3)、NewLine:每当调用WriteLine()方法是,行结束字符串都会写入到文本流中,该属性就是读取该结束字符串。
TextWriter重要方法:
(1)、Close():关闭TextWriter并且释放TextWriter的资源
(2)、Dispose():释放TextWriter所占用的所有资源(和StreamReader相似,一旦TextWriter被释放,它所占用的资源如Stream会一并释放)
(3)、Flush():和Stream类中一样,将缓冲区所有的数据立刻写入文件(基础设备)
(4)、Write():方法的重载(这个方法重载太多,所以这里不全写出了,大家可以参考最后一个例子,打印结果)
(5)、WriteLine():方法的重载,和Write()方法相比,区别在于每个重载执行完毕之后都会附加写入一个换行符
二、StreamWriter
首先我们先了解一下StreamWriter的概念:实现一个TextWriter,使其以一种特定的编码向流中写入字符。
那会有很多朋友疑惑,StreamWriter和TextWriter有什么区别呢?
其实从名字定义我们便可区别了,TextWriter分别是对连续字符系列处理的编写器,而StreamWriter通过特定的编码和流的方式对数据进行处理的编写器。
1、StreamWriter的构造函数:
(1)、public StreamWriter(string path); 参数path表示文件所在的位置
(2)、public StreamWriter(Stream stream,Encoding encoding);参数Stream表示可以接收Stream的任何子类或派生类,Encoding表示让StreamWriter在写操作时使用该Encoding进行性编码操作
(3)、public StreamWriter(string path,bool append);第二个append参数非常重要,当append参数为true时,StreamWriter会通过path去找当前文件是否存在,如果存在则进行append或overwrite的操作,否则创建新的文件
(4)、public StreamWriter(Stream stream,Encoding encoding,int bufferSize);bufferSize参数设置当前StreamWriter的缓冲区的大小
2、SteamWriter的属性
StreamWriter的方法大多都继承了TextWriter这里就不再重复叙述了,这里就简单介绍一下StreamWriter独有的属性:
(1)、AutoFlush:这个值来指示每次使用Write()方法后直接将缓冲区的数据写入文件(基础流)
(2)、BaseStream:和StreamReader相似,可以取出当前的Stream对象加以处理
三、StreamWriter示例:
下面我们就简单的几个示例来看一下以上的属性方法如何使用的:
const string txtFilePath = "D:\\TextWriter.txt"; static void Main(string[] args) { NumberFormatInfo numberFomatProvider = new NumberFormatInfo(); //将小数 “.”换成"?" numberFomatProvider.PercentDecimalSeparator = "?"; StreamWriterTest test = new StreamWriterTest(Encoding.Default, txtFilePath, numberFomatProvider); //StreamWriter test.WriteSomthingToFile(); //TextWriter test.WriteSomthingToFileByUsingTextWriter(); Console.ReadLine(); } } /// <summary> /// TextWriter和StreamWriter的举例 /// </summary> public class StreamWriterTest { /// <summary> /// 编码 /// </summary> private Encoding _encoding; /// <summary> /// IFomatProvider /// </summary> private IFormatProvider _provider; /// <summary> /// 文件路径 /// </summary> private string _textFilePath; public StreamWriterTest(Encoding encoding, string textFilePath) : this(encoding, textFilePath, null) { } public StreamWriterTest(Encoding encoding, string textFilePath, IFormatProvider provider) { this._encoding = encoding; this._textFilePath = textFilePath; this._provider = provider; } /// <summary> /// 我们可以通过FileStream 或者 文件路径直接对该文件进行写操作 /// </summary> public void WriteSomthingToFile() { //获取FileStream using (FileStream stream = File.OpenWrite(_textFilePath)) { //获取StreamWriter using (StreamWriter writer = new StreamWriter(stream, this._encoding)) { this.WriteSomthingToFile(writer); } //也可以通过文件路径和设置bool append,编码和缓冲区来构建一个StreamWriter对象 using (StreamWriter writer = new StreamWriter(_textFilePath, true, this._encoding, 20)) { this.WriteSomthingToFile(writer); } } } /// <summary> /// 具体写入文件的逻辑 /// </summary> /// <param name="writer">StreamWriter对象</param> public void WriteSomthingToFile(StreamWriter writer) { //需要写入的数据 string[] writeMethodOverloadType = { "1.Write(bool);", "2.Write(char);", "3.Write(Char[])", "4.Write(Decimal)", "5.Write(Double)", "6.Write(Int32)", "7.Write(Int64)", "8.Write(Object)", "9.Write(Char[])", "10.Write(Single)", "11.Write(Char[])", "12.Write(String)", "13Write(UInt32)", "14.Write(string format,obj)", "15.Write(Char[])" }; //定义writer的AutoFlush属性,如果定义了该属性,就不必使用writer.Flush方法 writer.AutoFlush = true; writer.WriteLine("这个StreamWriter使用了{0}编码", writer.Encoding.HeaderName); //这里重新定位流的位置会导致一系列的问题 //writer.BaseStream.Seek(1, SeekOrigin.Current); writer.WriteLine("这里简单演示下StreamWriter.Writer方法的各种重载版本"); writeMethodOverloadType.ToList().ForEach ( (name) => { writer.WriteLine(name); } ); writer.WriteLine("StreamWriter.WriteLine()方法就是在加上行结束符,其余和上述方法是用一致"); //writer.Flush(); writer.Close(); } public void WriteSomthingToFileByUsingTextWriter() { using (TextWriter writer = new StringWriter(_provider)) { writer.WriteLine("这里简单介绍下TextWriter 怎么使用用户设置的IFomatProvider,假设用户设置了NumberFormatInfoz.PercentDecimalSeparator属性"); writer.WriteLine("看下区别吧 {0:p10}", 0.12); Console.WriteLine(writer.ToString()); writer.Flush(); writer.Close(); } } }
输出结果:
TextWriter输出结果:
好了,这次的StreamWriter就介绍到这里了。非常感谢 逆时针の风 的博客对我的帮助。