IFormattable,IFormatProvider,ICustomFormatter 接口的实现

IFormattable,IFormatProvider,ICustomFormatter 接口的实现

.NET Framework提供了方法，能够将任何数值、枚举以及日期和时间等基数据类型表示为字符串
格式化由格式说明符字符的字符串控制，该字符串指示如何表示基类型值
例如，格式说明符指示：是否应该用科学记数法来表示格式化的数字
例如:格式字符"C",说明货币格式

同时.NET Framework还使用区域性设置，以便用适合于特定区域性的形式表示基类型。
我们可以提供自定义的区域性设置，或者使用与当前线程关联的默认区域性设置。
例如，格式化货币类型的时候，区域性设置指定用于货币符号

要是我们想拥有自己定义的格式化,.NET Framework也允许我们定义自己格式化方案和自定义区域性设置。
例如:我想格式字符"MyFormat",来说明我自定义的格式,即在字符前加三个***

关于数字格式字符串,可以参考类
System.Globalization.NumberFormatInfo
关于日期与时间格式字符串,可以参考类
System.Globalization.DateTimeFormatInfo

先看看IFormattable接口的原型
public interface IFormattable
{
      // Methods
      string ToString(string format, IFormatProvider formatProvider);
}
参数说明：
format
指定要使用的格式的 String
当为空引用时，表示使用为 IFormattable 实现的类型定义的默认格式
formatProvider
用于格式化该值的 IFormatProvider
当为空引用时，从操作系统的当前区域设置中获取格式信息的

一些基本的值类型实现了该接口,例如:
Int32 ，UInt32 ， DateTime ，Guid ，类Enum

再看看IFormatProvider接口的原型
public interface IFormatProvider
{
      // Methods
      object GetFormat(Type formatType);
}
参数说明：
formatType
一个对象，它指定要获取的格式对象的类型

NumberFormatInfo、DateTimeFormatInfo和CultureInfo实现IFormatProvider接口

NumberFormatInfo提供数字格式信息，如用于小数分隔符和千位分隔符的字符，以及货币值中货币符号的拼写和位置
DateTimeFormatInfo提供与日期相关和与时间相关的格式信息，如日期模式中月、日和年的位置
CultureInfo包含特定区域性中的默认格式信息，其中包括数字格式信息以及与日期相关和与时间相关的格式信息

再看看ICustomFormatter接口的原型
public interface ICustomFormatter
{
      // Methods
      string Format(string format, object arg, IFormatProvider formatProvider);
}
参数说明：
format
包含格式规范的格式字符串
arg
要格式化的对象
formatProvider
一个 IFormatProvider 对象，它提供有关当前实例的格式信息

在arg为空引用时，引发异常
如果 format 为空引用 ，将使用默认格式规范
如果 formatProvider 为空引用 ，则忽略该参数

好了,说了这么多
我们来动手来实现格式字符"MyFormat",在字符前加三个***的需求

定义一个类

using  System;

namespace  MyFormat
{
     public   class  MyClass : System.IFormattable
     {
        Double d;

         public  MyClass(Double d)
         {
             this .d = d;
        }

         public   string  ToString( string  format, IFormatProvider formatProvider)
         {
             return  (format == " MyFormat " ) ? " *** " + d.ToString(formatProvider):d.ToString(format,formatProvider);
        }
    }
}

再到一控制台中

System.Globalization.CultureInfo culture = null ;

            MyClass myClass = new  MyClass( 5 );
             // 当IFormatProvider为空时,调用的是当前线程关联的文化信息
            Console.WriteLine( " 显示中国货币格式:{0} " ,myClass.ToString( " C " , null ));

            culture = System.Globalization.CultureInfo.CurrentCulture;
            Console.WriteLine( " 显示当前系统默认货币格式:{0} " ,myClass.ToString( " C " ,culture));

            culture = new  System.Globalization.CultureInfo( " zh-HK " );
            Console.WriteLine( " 显示香港特别行政区货币格式:{0} " ,myClass.ToString( " C " ,culture));

            Console.WriteLine( " 显示我自己定义的货币格式:{0} " ,myClass.ToString( " MyFormat " , null ));
            
            Console.ReadLine();

效果如下:


如果希望自定义格式化能在多个不同类使用，那么实现我们应该实现ICustomFormatter接口

定义一个类

using  System;

namespace  MyFormat
{
    public class MyBaseFormat : System.ICustomFormatter, System.IFormatProvider
    {
        //如果format Type与当前实例类型相同，则为当前实例，否则为空引用
        public object GetFormat(Type format)
        {
            if (format == typeof (ICustomFormatter))
                return this;
            return null;
        }

        //实现Format方法说明:
        //如果您的格式方法不支持格式，则确定正在设置格式的对象是否实现 IFormattable 接口。
        //如果实现，请调用该接口的IFormattable.ToString 方法。
        //否则，调用基础对象的默认 Object.ToString 方法。
        public string Format (string format, object arg, IFormatProvider provider)
        {
            if (format == null)
            {
                if (arg is IFormattable)
                    return ((IFormattable)arg).ToString(format, provider);
                return arg.ToString();
            }
            else
            {
                if (format=="MyBaseFormat")  
                {
                    return "***"+arg.ToString();
                }
                else
                {
                    if (arg is IFormattable)
                        return ((IFormattable)arg).ToString(format, provider);
                    return arg.ToString();
                }
            }
        }
    }
}

到一控制台中

             string  printString = String.Empty;
             int  i = 100 ;
            MyBaseFormat myBaseFormat = new  MyBaseFormat();

            printString = string .Format(myBaseFormat, " 显示正常格式:{0} " ,i);
            Console.WriteLine(printString);
            printString = string .Format(myBaseFormat, " 显示正常格式:{0:C} " ,i);
            Console.WriteLine(printString);
            printString = string .Format(myBaseFormat, " 显示自定义格式{0:MyBaseFormat} " ,i);
            Console.WriteLine(printString);

            Console.ReadLine();

效果如下:


小总结:
1.如果需要您自己的格式化包含在某个类上，在该类上实现IFormattable接口
2.如果希望自定义格式化并使它可供多个不同类使用，那么实现 ICustomFormatter接口

希望上面提到的知识对你有所提示
当然欢迎交流和指正

blog:
http://www.cnblogs.com/aierong
author:aierong
email:[email protected]

写随笔费时又费力，请尊重作者的权利
谢谢！
namespace Microshaoft
{
    using System;

    public class ChineseFormat : System.ICustomFormatter, System.IFormatProvider
    {
        //如果format Type与当前实例类型相同，则为当前实例，否则为空引用 
        public object GetFormat(Type format)
        {
            if (format == typeof (ICustomFormatter))
            {
                return this;
            }
            return null;
        }

        //实现Format方法说明: 
        //如果您的格式方法不支持格式，则确定正在设置格式的对象是否实现 IFormattable 接口。 
        //如果实现，请调用该接口的IFormattable.ToString 方法。 
        //否则，调用基础对象的默认 Object.ToString 方法。 
        public string Format(string format, object arg, IFormatProvider provider)
        {
            if (format == null)
            {
                if (arg is IFormattable)
                {
                    return ((IFormattable) arg).ToString(format, provider);
                }
                return arg.ToString();
            }
            else
            {
                if (format == "ChineseFormat")
                {
                    string[] Nums = new string[] {"零", "壹", "贰", "叁", "肆", "伍", "陆", "柒", "捌", "玖"};
                    //位 数组 
                    string[] Digits = new string[] {"", "拾", "佰", "仟"};
                    //单位 数组 
                    string[] Units = new string[] {"", "[万]", "[亿]", "[万亿]"};
                    return ConvertNumberToChinese(arg.ToString(), Nums, Digits, Units);
                    //return "***"+arg.ToString(); 
                }
                else
                {
                    if (arg is IFormattable)
                    {
                        return ((IFormattable) arg).ToString(format, provider);
                    }
                    return arg.ToString();
                }
            }
        }

        public static string ConvertNumberToChinese(string x, string[] Nums, string[] Digits, string[] Units)
        {
            string S = ""; //返回值 
            int p = 0; //字符位置指针 
            int m = x.Length % 4; //取模 

            // 四位一组得到组数 
            int k = (m > 0 ? x.Length / 4 + 1 : x.Length / 4);

            // 外层循环在所有组中循环 
            // 从左到右 高位到低位 四位一组 逐组处理 
            // 每组最后加上一个单位: "[万亿]","[亿]","[万]" 
            for (int i = k; i > 0; i--)
            {
                int L = 4;
                if (i == k && m != 0)
                {
                    L = m;
                }
                // 得到一组四位数 最高位组有可能不足四位 
                string s = x.Substring(p, L);
                int l = s.Length;

                // 内层循环在该组中的每一位数上循环 从左到右 高位到低位 
                for (int j = 0; j < l; j++)
                {
                    //处理改组中的每一位数加上所在位: "仟","佰","拾",""(个) 
                    int n = Convert.ToInt32(s.Substring(j, 1));
                    if (n == 0)
                    {
                        if (j < l - 1
                            && Convert.ToInt32(s.Substring(j + 1, 1)) > 0 //后一位(右低) 
                            && !S.EndsWith(Nums[n]))
                        {
                            S += Nums[n];
                        }
                    }
                    else
                    {
                        //处理 1013 一千零"十三", 1113 一千一百"一十三" 
                        if (!(n == 1 && (S.EndsWith(Nums[0]) | S.Length == 0) && j == l - 2))
                        {
                            S += Nums[n];
                        }
                        S += Digits[l - j - 1];
                    }
                }
                p += L;
                // 每组最后加上一个单位: [万],[亿] 等 
                if (i < k) //不是最高位的一组 
                {
                    if (Convert.ToInt32(s) != 0)
                    {
                        //如果所有 4 位不全是 0 则加上单位 [万],[亿] 等 
                        S += Units[i - 1];
                    }
                }
                else
                {
                    //处理最高位的一组,最后必须加上单位 
                    S += Units[i - 1];
                }
            }
            return S;
        }
    }
}

namespace Test
{
    using System;
    using Microshaoft;

    class AppTest
    {
        static void Main()
        {
            string printString = String.Empty;
            long i = 1100000013;
            ChineseFormat fmt = new ChineseFormat();

            printString = string.Format(fmt, "显示正常格式: {0}", i);
            Console.WriteLine(printString);
            printString = string.Format(fmt, "显示正常格式: {0:C}", i);
            Console.WriteLine(printString);
            printString = string.Format(fmt, "显示自定义格式: {0:ChineseFormat}", i);
            Console.WriteLine(printString);

            Console.ReadLine();
        }
    }
}
来自:aierong原创技术随笔(.Net方向应用)