C# 温故而知新:Stream篇(三)

TextWriter 和 StreamWriter

目录:

  • 为何介绍TextWriter?
  • TextWriter的构造,常用属性和方法
  • IFormatProvider的简单介绍
  • 如何理解StreamWriter?
  • StreamWriter属性
  • StreamWriter示例
  • 本章总结

为何介绍TextWriter?

就像上篇讲述的一样,对于重要的基础技术,我们一定要刨根问底,这样在面对将来可能很复杂的业务或技术时才能游刃有余,

甚至可以创新出新的解决方案,言归正传,想了解StreamWriter 必须了解其父亲TextWriter的结构和使用方法。

那么微软为什么要创建立这个抽象类呢?看下图

的确可以这样理解C,C++ ,XAML,Html一切可以写在文本上写的语言都可以用Text这个词在抽象,(千万别小看记事本,它才是元老啊),

聪明的你想到了,今后我们可以自定义一些自己Writer类来实现我们特定的写功能。现在我们只要理解TextWriter是一个抽象的文本写入器,

可以在文本上写入我们想要的格式,可以通过微软派生类或着自定义派生类来实现TextWriter的功能。只要你有足够的想象力就能在创新

出一个新的派生类。

TextWriter的构造,常用属性和方法

以下是TextWriter构造函数:

和所有的抽象类一样,该类不能直接实例化,它有2个构造函数

特别我想说下第二个构造函数,大家发现这个构造有个IFomatProvider 类型的参数, 这个是什么东东?

IFormatProvider接口的简单介绍

其实IFormatProvider接口 从字面上就能理解了,一个格式化的提供者

大家记得我们常用的string.format(“{0:P}”,data);么? IFormatProvider在这里被隐式的调用了

关于隐式调用的各种方式,用个简单的例子向大家说明下:

//有关数字格式化隐性使用IFomatProvider的例子
#if true
            //货币
            Console.WriteLine(string.Format("显示货币格式{0:c3}",12));
            //十进制
            Console.WriteLine("显示货币十进制格式{0:d10}", 12);
            //科学计数法
            Console.WriteLine("科学计数法{0:e5}",12);
            //固定点格式
            Console.WriteLine("固定点格式 {0:f10}",12);
            //常规格式
            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

输出结果:

也就是说IFormatProvider 提供了一个格式化的工具。

让我们通过NumberFormatInfo类来温故下:

这个密封类实现了IFormatProvider接口,主要实现了一个数字格式化的类,下面是一些规定的格式说明符:

c、C

货币格式。关联的属性包括:

d、D

十进制格式。

e、E

科学计数(指数)格式。

f、F

固定点格式。

g、G

常规格式。

n、N

数字格式。

p、P

百分比格式。

让我们用简单易懂的代码来实现下NumberFormatInfo 如何使用:

#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类来实现特殊的

字符串格式化,关于这个重要的知识点我会在另一篇文章中详细介绍并且自定义一个简单的FormatInfo类

言归正传让我们理解下TextWriter的几个重要属性

*1:Encoding: 可以获得当前TextWriter的Encoding

*2:FormatProvider: 可以获得当前TextWriter的IFormatProvider

*3:NewLine: 每当调用WriteLine()方法时,行结束符字符串都会写入到文本流中,该属性就是读取

该结束符字符串

方法:

*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通过特定的编码和流的方式对数据进行处理的编写器

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的缓冲区的大小

StreamWriter的属性

StreamWriter的方法大多都继承了TextWriter 这里就不在重复叙述了,这里就简单介绍下StreamWriter独有的属性

*1:AutoFlush: 这个值来指示每次使用streamWriter.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();
            }


        }
    }

StreamWriter输出结果:

TextWriter 输出结果

相信大家看完这个示例后能对StreamWriter和TextWriter有一个更深的理解

本章总结

本章讲述了 TextWriter 和 StreamWriter的一些基本的概念操作和区别,还有略带介绍了IFomartProvider接口的基本作用,

由于IFomartProvider也是非常重要的一个接口,我也会单独写一篇关于它的博文,至此关于流的一些准备工作已经完成

原文发布于微信公众号 - 我为Net狂(dotNetCrazy)

原文发表时间:2016-06-28

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏魂祭心

原 荐 NEO VM原理及其实现

4248
来自专栏草根专栏

使用xUnit为.net core程序进行单元测试(2)

下面有一点点内容是重叠的.... String Assert 测试string是否相等: [Fact] public void ...

5457
来自专栏Porschev[钟慰]的专栏

用泛型的IEqualityComparer<T>接口去重复项

写这个源于CSDN一位网友的提问 题目:下列数据放在一个List中,当ID和Name都相同时,去掉重复数据 ID Name 1  张三 1  李三 1  小伟 ...

1949
来自专栏风口上的猪的文章

.NET面试题系列[14] - LINQ to SQL与IQueryable

"理解IQueryable的最简单方式就是,把它看作一个查询,在执行的时候,将会生成结果序列。" - Jon Skeet

1461
来自专栏技术博客

编写高质量代码改善C#程序的157个建议[IEnumerable<T>和IQueryable<T>、LINQ避免迭代、LINQ替代迭代]

本文已更新至http://www.cnblogs.com/aehyok/p/3624579.html 。本文主要学习记录以下内容:

1205
来自专栏行者常至

019.数据交换格式:Json、XML

数据交换格式中,最核心的就是Json和XML。 其中,Json是一种轻量级数据交换格式,XML是一种重量级的数据交换格式。 相比于xml这种数据交换格式来说...

1773
来自专栏前端侠2.0

c# 的析构以及垃圾回收2、3事!

看书时,自己写的例子代码,了解到几个知识点,记载下来。同时发现自己手写代码的能力比较弱,还是得多写一下。

781
来自专栏java架构师

Stream篇(1)

最近在看一个写的很好的博客,为了加深记忆,把自认为重要的东西,一边看,一边记在这里 一、什么是流、字节序列、字节 一条河中有一条鱼游过,这条鱼就是一个字节,这个...

3037
来自专栏程序员的SOD蜜

不使用反射的实体类方案

看过很多ORM的实体类方案,大多是用反射来读数据库数据,这样当频繁操作实体类的时候效率很低,我借鉴了一位朋友的思路,采用.NET 2.0的泛型技术,为实体类提供...

2198
来自专栏大内老A

Delegate如何进行类型转换?

我们知道对于两个不具有继承关系的两个类型,如果没有为它们定义转换器,两这之间的类型转换是不允许的,Delegate也是如此。但是有时候我们却希望“兼容”的两种D...

2068

扫码关注云+社区

领取腾讯云代金券