System.Convert.ToString 方法 (Object, IFormatProvider)

方法描述

使用指定的区域性特定格式设置信息将指定对象的值转换为其等效的字符串表示形式。

语法定义(C# System.Convert.ToString 方法 (Object, IFormatProvider) 的用法)

public static string ToString(
	Object value,
	IFormatProvider provider
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
value System-Object 一个对象,用于提供要转换的值,或 null。
provider System-IFormatProvider 一个提供区域性特定的格式设置信息的对象。
返回值 System.String value 的字符串表示形式,如果 value 为 null,则为 String.Empty。

提示和注释

如果 value 参数实现 IConvertible 接口,则实现的 IConvertible.ToString(IFormatProvider) 方法生成返回值。 否则,如果 value 参数实现 IFormattable 接口,则实现的 IFormattable.ToString(String, IFormatProvider) 方法生成返回值。 如果 value 没有实现借口,则由 value 参数的 ToString() 方法生成返回值。

如果 value 参数实现 IConvertible 或 IFormattable 接口,则使用 provider 参数。 provider 参数指定 value 转换中使用的特定于区域性的信息。 例如,如果 value 参数是一个负小数,则 provider 参数可以提供有关负号和小数点分隔符所使用表示法的区域性特定信息。

System.Convert.ToString 方法 (Object, IFormatProvider)例子

该示例演示如何调用 Convert.ToString(Object, IFormatProvider) 方法然后调用 Temperature.ToString 方法。

using System;

public class Temperature
{
   private decimal m_Temp;

   public Temperature(decimal temperature)
   {
      this.m_Temp = temperature;
   }

   public decimal Celsius
   {
      get { return this.m_Temp; }   
   }

   public decimal Kelvin
   {
      get { return this.m_Temp + 273.15m; }    
   }

   public decimal Fahrenheit
   {
      get { return Math.Round((decimal) (this.m_Temp * 9 / 5 + 32), 2); }
   }

   public override string ToString()
   {
      return m_Temp.ToString("N2") + " °C";
   }

}

public class Example
{
   public static void Main()
   {
      Temperature cold = new Temperature(-40);
      Temperature freezing = new Temperature(0);
      Temperature boiling = new Temperature(100);

      Console.WriteLine(Convert.ToString(cold, null));
      Console.WriteLine(Convert.ToString(freezing, null));
      Console.WriteLine(Convert.ToString(boiling, null));
   }
}
// The example dosplays the following output:
//       -40.00 °C
//       0.00 °C
//       100.00 °C

异常

异常 异常描述

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。