《Effective C#》读书笔记——条目5:为类型提供ToString()方法<C#语言习惯>

简介:

  ToString()方法作为.NET环境中最常用的方法之一,我们应该为类型的所有者提供一个合理的ToString()版本,类型的字符串表示可用来在不同的环境下向用户轻松显示对象的相关信息;此外,类型的字符串表示还可以拥有调试环境。因此,我们创建的每一个类型都应该能覆写Object类的ToString()方法。如果创建的是更负责的类型,那么还应该实现更加完备的IFormattable.ToString()方法。

  System.Ojbetc默认提供的ToString()方法会返回类型的完整名称。就像:"System.Drawing.Rect"、"System.Data.Common.DbConnection",这一般没什么用处,也不适合直接显示给用户。所以我们只需要重写一次,即可一劳永逸。

  通过一个示例我们来学习如何为一个类型提供一个容易理解的,文本方式的表示。例如我们有一个包含三个字段的Customer类:

复制代码
 1 class Customer
 2     {
 3         /// <summary>
 4         /// 姓名
 5         /// </summary>
 6         public string Name
 7         {
 8             get;
 9             set;
10         }
11 
12         /// <summary>
13         /// 收入
14         /// </summary>
15         public decimal Revenue
16         {
17             get;
18             set;
19         }
20 
21         /// <summary>
22         /// 联系电话
23         /// </summary>
24         public string ContactPhone
25         {
26             get;
27             set;
28         }
29 
30         /// <summary>
31         /// 覆写ToString方法,提供该类型更易理解的文本表示方式
32         /// </summary>
33         /// <returns></returns>
34         public override string ToString()
35         {
36             return Name;
37         }
38     }
复制代码

对于Customer类来说,返回它的Name是一个不错的选择。在提供了Customer类的ToString()覆写之后,该类的对象即可更容易的添加到WPF控件、Silverlight控件、Web Forms控件或者被打印输出。.NET BCL(.NET Framework 基础类库)在将对象显示到如组合框、列表框、文本框或其他控件上时使用Object.ToString()的覆写版本。

提示: 

  在C#3.0中,编译器会为所以匿名类型创建一个默认的ToString()方法。该默认方法将显示对象中的每个属性值。

例如我们运行控制台程序:

复制代码
 1   class Program
 2     {
 3         static void Main(string[] args)
 4         {
 5             int[] list = new int[] { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 };
 6             var test = new { Name = "me", Numbes = from li in list select 1 };
 7 
 8             Console.WriteLine(test);
 9             Console.Read();
10         }
11     }
复制代码

运行程序:

 

实现IFormattable接口

  虽然简单的ToString()方法很多时候已经可以满足用户自定义类型显示文本信息的需求,但有时还需要提供更强的方法。在前面的Customer类的ToString()方法中我们只是简单的返回了它的Name这个字段。如果我们想要拥有更加详细的返回,我们可以通过覆写IFormattable接口来解决这个不足。该接口包含了一个重载的ToString()方法,它允许我们为类型提供特定的格式信息。当你需要为类型输出不同形式的字符串时,这个接口即可大显身手。在下面的例子中我们可以使用特定的字符串来表示某种格式的信息,如n来表示名称等:

复制代码
 1     public class Customer : IFormattable
 2     {
 3         //属性字段省略...
 4 
 5         public string ToString(string format, IFormatProvider formatProvider)
 6         {
 7             if (formatProvider != null)
 8             {
 9                 ICustomFormatter fmt = formatProvider.GetFormat(this.GetType()) as ICustomFormatter;
10                 if (fmt != null)
11                     return fmt.Format(format, this, formatProvider);
12             }
13             switch (format)
14             {
15                 case "r":
16                     return Revenue.ToString();
17                 case "p":
18                     return ContactPhone;
19                 case "nr":
20                     return string.Format("{0,20},{1,10:C}", Name, Revenue);
21                 case "np":
22                     return string.Format("{0,15},{1,10:C}", Name, ContactPhone);
23                 case "n":
24                 case "G":
25                 default:
26                     return Name;
27             }
28         }
29     }
复制代码

Customer使用者即可自定义其想要输出的格式:

1             IFormattable c1 = new Customer();
2             Console.WriteLine("Customer record:{0}", c1.ToString("nr", null));

 

 首先我们必须支持表示通用格式的"G";其次我们必须支持两种格式的空格式,即" "和null。这三种格式返回字符串都必须和Ojbect.ToString()的覆写版本的字符串相同。实现了IFormattable接口的类型,.NET BCL都会调用IFormattable()而不是Object.ToString()。

 

IFormatProvider接口

  IFormattable.ToString()方法的第二个参数是一个实现IFormatProvider接口的对象,该对象允许客户端提供一些我们无法事先预料的格式化选项。更详细的说明参见:IFormatProvider接口

 

小节:

  人们总是要通过某种方式获取到类型的信息,而字符串的表示则是最通俗易懂的。因此,我们应该覆写所以类型中的ToString()方法,让其简单明了的输出对象的摘要信息。

阅读书目:《Effective C#》

扩展阅读:

标准数字格式字符串

自定义数字格式字符串

本文转自gyzhao博客园博客,原文链接:http://www.cnblogs.com/IPrograming/archive/2012/08/22/Effective_CSharp_05.html ,如需转载请自行联系原作者
相关文章
|
3月前
|
开发框架 .NET 程序员
C# 去掉字符串最后一个字符的 4 种方法
在实际业务中,我们经常会遇到在循环中拼接字符串的场景,循环结束之后拼接得到的字符串的最后一个字符往往需要去掉,看看 C# 提供了哪4种方法可以高效去掉字符串的最后一个字符
356 0
|
2月前
|
编译器 C#
C#多态概述:通过继承实现的不同对象调用相同的方法,表现出不同的行为
C#多态概述:通过继承实现的不同对象调用相同的方法,表现出不同的行为
128 65
|
1月前
|
JSON 程序员 C#
使用 C# 比较两个对象是否相等的7个方法总结
比较对象是编程中的一项基本技能,在实际业务中经常碰到,比如在ERP系统中,企业的信息非常重要,每一次更新,都需要比较记录更新前后企业的信息,直接比较通常只能告诉我们它们是否指向同一个内存地址,那我们应该怎么办呢?分享 7 个方法给你!
|
1月前
|
C# UED SEO
C# 异步方法async / await任务超时处理
通过使用 `Task.WhenAny`和 `Task.Delay`方法,您可以在C#中有效地实现异步任务的超时处理机制。这种方法允许您在指定时间内等待任务完成,并在任务超时时采取适当的措施,如抛出异常或执行备用操作。希望本文提供的详细解释和代码示例能帮助您在实际项目中更好地处理异步任务超时问题,提升应用程序的可靠性和用户体验。
73 3
|
1月前
|
编译器 C#
c# - 运算符<<不能应用于long和long类型的操作数
在C#中,左移运算符的第二个操作数必须是 `int`类型,因此需要将 `long`类型的位移计数显式转换为 `int`类型。这种转换需要注意数据丢失和负值处理的问题。通过本文的详细说明和示例代码,相信可以帮助你在实际开发中正确使用左移运算符。
37 3
|
1月前
|
编译器 C#
c# - 运算符<<不能应用于long和long类型的操作数
在C#中,左移运算符的第二个操作数必须是 `int`类型,因此需要将 `long`类型的位移计数显式转换为 `int`类型。这种转换需要注意数据丢失和负值处理的问题。通过本文的详细说明和示例代码,相信可以帮助你在实际开发中正确使用左移运算符。
62 1
|
2月前
|
存储 C#
【C#】大批量判断文件是否存在的两种方法效率对比
【C#】大批量判断文件是否存在的两种方法效率对比
52 1
|
1月前
|
编译器 C#
c# - 运算符<<不能应用于long和long类型的操作数
在C#中,左移运算符的第二个操作数必须是 `int`类型,因此需要将 `long`类型的位移计数显式转换为 `int`类型。这种转换需要注意数据丢失和负值处理的问题。通过本文的详细说明和示例代码,相信可以帮助你在实际开发中正确使用左移运算符。
18 0
|
2月前
|
C#
C# 可空类型(Nullable)
C# 单问号 ? 与 双问号 ??
60 12
|
2月前
|
C#
C#的方法的参数传递
C#的方法的参数传递
29 0