Convert 类

• ChangeType 方法
• ChangeType 方法 1
• ChangeType 方法 2
• ChangeType 方法 3
• FromBase64CharArray 方法
• FromBase64String 方法
• GetTypeCode 方法
• IsDBNull 方法
• ToBase64CharArray 方法
• ToBase64CharArray 方法 1
• ToBase64String 方法
• ToBase64String 方法 1
• ToBase64String 方法 2
• ToBase64String 方法 3
• ToBoolean 方法
• ToBoolean 方法 1
• ToBoolean 方法 2
• ToBoolean 方法 3
• ToBoolean 方法 4
• ToBoolean 方法 5
• ToBoolean 方法 6
• ToBoolean 方法 7
• ToBoolean 方法 8
• ToBoolean 方法 9
• ToBoolean 方法 10
• ToBoolean 方法 11
• ToBoolean 方法 12
• ToBoolean 方法 13
• ToBoolean 方法 14
• ToBoolean 方法 15
• ToBoolean 方法 16
• ToBoolean 方法 17
• ToByte 方法
• ToByte 方法 1
• ToByte 方法 2
• ToByte 方法 3
• ToByte 方法 4
• ToByte 方法 5
• ToByte 方法 6
• ToByte 方法 7
• ToByte 方法 8
• ToByte 方法 9
• ToByte 方法 10
• ToByte 方法 11
• ToByte 方法 12
• ToByte 方法 13
• ToByte 方法 14
• ToByte 方法 15
• ToByte 方法 16
• ToByte 方法 17
• ToByte 方法 18
• ToChar 方法
• ToChar 方法 1
• ToChar 方法 2
• ToChar 方法 3
• ToChar 方法 4
• ToChar 方法 5
• ToChar 方法 6
• ToChar 方法 7
• ToChar 方法 8
• ToChar 方法 9
• ToChar 方法 10
• ToChar 方法 11
• ToChar 方法 12
• ToChar 方法 13
• ToChar 方法 14
• ToChar 方法 15
• ToChar 方法 16
• ToChar 方法 17
• ToDateTime 方法
• ToDateTime 方法 1
• ToDateTime 方法 2
• ToDateTime 方法 3
• ToDateTime 方法 4
• ToDateTime 方法 5
• ToDateTime 方法 6
• ToDateTime 方法 7
• ToDateTime 方法 8
• ToDateTime 方法 9
• ToDateTime 方法 10
• ToDateTime 方法 11
• ToDateTime 方法 12
• ToDateTime 方法 13
• ToDateTime 方法 14
• ToDateTime 方法 15
• ToDateTime 方法 16
• ToDateTime 方法 17
• ToDecimal 方法
• ToDecimal 方法 1
• ToDecimal 方法 2
• ToDecimal 方法 3
• ToDecimal 方法 4
• ToDecimal 方法 5
• ToDecimal 方法 6
• ToDecimal 方法 7
• ToDecimal 方法 8
• ToDecimal 方法 9
• ToDecimal 方法 10
• ToDecimal 方法 11
• ToDecimal 方法 12
• ToDecimal 方法 13
• ToDecimal 方法 14
• ToDecimal 方法 15
• ToDecimal 方法 16
• ToDecimal 方法 17
• ToDouble 方法
• ToDouble 方法 1
• ToDouble 方法 2
• ToDouble 方法 3
• ToDouble 方法 4
• ToDouble 方法 5
• ToDouble 方法 6
• ToDouble 方法 7
• ToDouble 方法 8
• ToDouble 方法 9
• ToDouble 方法 10
• ToDouble 方法 11
• ToDouble 方法 12
• ToDouble 方法 13
• ToDouble 方法 14
• ToDouble 方法 15
• ToDouble 方法 16
• ToDouble 方法 17
• ToInt16 方法
• ToInt16 方法 1
• ToInt16 方法 2
• ToInt16 方法 3
• ToInt16 方法 4
• ToInt16 方法 5
• ToInt16 方法 6
• ToInt16 方法 7
• ToInt16 方法 8
• ToInt16 方法 9
• ToInt16 方法 10
• ToInt16 方法 11
• ToInt16 方法 12
• ToInt16 方法 13
• ToInt16 方法 14
• ToInt16 方法 15
• ToInt16 方法 16
• ToInt16 方法 17
• ToInt16 方法 18
• ToInt32 方法
• ToInt32 方法 1
• ToInt32 方法 2
• ToInt32 方法 3
• ToInt32 方法 4
• ToInt32 方法 5
• ToInt32 方法 6
• ToInt32 方法 7
• ToInt32 方法 8
• ToInt32 方法 9
• ToInt32 方法 10
• ToInt32 方法 11
• ToInt32 方法 12
• ToInt32 方法 13
• ToInt32 方法 14
• ToInt32 方法 15
• ToInt32 方法 16
• ToInt32 方法 17
• ToInt32 方法 18
• ToInt64 方法
• ToInt64 方法 1
• ToInt64 方法 2
• ToInt64 方法 3
• ToInt64 方法 4
• ToInt64 方法 5
• ToInt64 方法 6
• ToInt64 方法 7
• ToInt64 方法 8
• ToInt64 方法 9
• ToInt64 方法 10
• ToInt64 方法 11
• ToInt64 方法 12
• ToInt64 方法 13
• ToInt64 方法 14
• ToInt64 方法 15
• ToInt64 方法 16
• ToInt64 方法 17
• ToInt64 方法 18
• ToSByte 方法
• ToSByte 方法 1
• ToSByte 方法 2
• ToSByte 方法 3
• ToSByte 方法 4
• ToSByte 方法 5
• ToSByte 方法 6
• ToSByte 方法 7
• ToSByte 方法 8
• ToSByte 方法 9
• ToSByte 方法 10
• ToSByte 方法 11
• ToSByte 方法 12
• ToSByte 方法 13
• ToSByte 方法 14
• ToSByte 方法 15
• ToSByte 方法 16
• ToSByte 方法 17
• ToSByte 方法 18
• ToSingle 方法
• ToSingle 方法 1
• ToSingle 方法 2
• ToSingle 方法 3
• ToSingle 方法 4
• ToSingle 方法 5
• ToSingle 方法 6
• ToSingle 方法 7
• ToSingle 方法 8
• ToSingle 方法 9
• ToSingle 方法 10
• ToSingle 方法 11
• ToSingle 方法 12
• ToSingle 方法 13
• ToSingle 方法 14
• ToSingle 方法 15
• ToSingle 方法 16
• ToSingle 方法 17
• ToString 方法
• ToString 方法 1
• ToString 方法 2
• ToString 方法 3
• ToString 方法 4
• ToString 方法 5
• ToString 方法 6
• ToString 方法 7
• ToString 方法 8
• ToString 方法 9
• ToString 方法 10
• ToString 方法 11
• ToString 方法 12
• ToString 方法 13
• ToString 方法 14
• ToString 方法 15
• ToString 方法 16
• ToString 方法 17
• ToString 方法 18
• ToString 方法 19
• ToString 方法 20
• ToString 方法 21
• ToString 方法 22
• ToString 方法 23
• ToString 方法 24
• ToString 方法 25
• ToString 方法 26
• ToString 方法 27
• ToString 方法 28
• ToString 方法 29
• ToString 方法 30
• ToString 方法 31
• ToString 方法 32
• ToString 方法 33
• ToString 方法 34
• ToString 方法 35
• ToUInt16 方法
• ToUInt16 方法 1
• ToUInt16 方法 2
• ToUInt16 方法 3
• ToUInt16 方法 4
• ToUInt16 方法 5
• ToUInt16 方法 6
• ToUInt16 方法 7
• ToUInt16 方法 8
• ToUInt16 方法 9
• ToUInt16 方法 10
• ToUInt16 方法 11
• ToUInt16 方法 12
• ToUInt16 方法 13
• ToUInt16 方法 14
• ToUInt16 方法 15
• ToUInt16 方法 16
• ToUInt16 方法 17
• ToUInt16 方法 18
• ToUInt32 方法
• ToUInt32 方法 1
• ToUInt32 方法 2
• ToUInt32 方法 3
• ToUInt32 方法 4
• ToUInt32 方法 5
• ToUInt32 方法 6
• ToUInt32 方法 7
• ToUInt32 方法 8
• ToUInt32 方法 9
• ToUInt32 方法 10
• ToUInt32 方法 11
• ToUInt32 方法 12
• ToUInt32 方法 13
• ToUInt32 方法 14
• ToUInt32 方法 15
• ToUInt32 方法 16
• ToUInt32 方法 17
• ToUInt32 方法 18
• ToUInt64 方法
• ToUInt64 方法 1
• ToUInt64 方法 2
• ToUInt64 方法 3
• ToUInt64 方法 4
• ToUInt64 方法 5
• ToUInt64 方法 6
• ToUInt64 方法 7
• ToUInt64 方法 8
• ToUInt64 方法 9
• ToUInt64 方法 10
• ToUInt64 方法 11
• ToUInt64 方法 12
• ToUInt64 方法 13
• ToUInt64 方法 14
• ToUInt64 方法 15
• ToUInt64 方法 16
• ToUInt64 方法 17
• ToUInt64 方法 18

方法描述

将一个基本数据类型转换为另一个基本数据类型。

语法定义(C# System.Convert 类 的用法)

public static class Convert

构造函数

成员/方法

提示和注释

Convert 类的静态方法用于支持 .NET Framework 中与基数据类型之间的转换。 受支持的基类型是 Boolean、Char、SByte、Byte、Int16、Int32、Int64、UInt16、UInt32、UInt64、Single、Double、Decimal、DateTime 和 String。

与基类型之间的转换

存在将每个基类型转换为每个其他基类型的转换方法。 但是，根据运行时基类型和目标基类型的值，对特定转换方法的实际调用会产生五种结果之一。 这五种结果如下：

无转换。 当尝试将一个类型转换为其本身时（如使用 Int32 类型参数调用 Convert.ToInt32(Int32)）会发生这种情况。 在这种情况下，此方法只是返回原始类型实例。

一个 InvalidCastException。 当不支持特定转换时会发生这种情况。 以下转换会引发 InvalidCastException。

将 Char 转换为 Boolean、Single、Double、Decimal 或 DateTime。

将 Boolean、Single、Double、Decimal 或 DateTime 转换为 Char。

将 DateTime 转换为 String 以外的任何其他类型。

将 String 以外的任何其他类型转换为 DateTime。

FormatException 。 当由于字符串格式不正确而导致将字符串值转换为任何其他基类型的尝试失败时，会发生该异常。 以下转换会引发该异常：

要转换为 Boolean 值的字符串不等于 Boolean.TrueString 或 Boolean.FalseString。

要转换为 Char 值的字符串由多个字符组成。

要转换为任何数值类型的字符串没有被识别为有效数字。

要转换为 DateTime 的字符串没有被识别为有效日期和时间值。

转换成功。 对于前面结果中未列出的两个不同基类型之间的转换，所有扩大转换和不会导致数据丢失的收缩转换都将成功，此方法将返回目标基类型的值。

一个 OverflowException。 当收缩转换导致数据丢失时会发生这种情况。 例如，尝试将值为 10000 的 Int32 实例转换为 Byte 类型会引发 OverflowException，因为 10000 超出了 Byte 数据类型的范围。

如果数字类型转换导致精度丢失（即某些最低有效位丢失），不引发异常。 但是，如果结果超出了特定转换方法的返回值类型所能表示的范围，则将引发异常。

例如，当将 Double 转换为 Single 时，可能会发生精度丢失，但并不引发异常。 但是，如果 Double 的值太大，无法由 Single 表示，则将引发溢出异常。

从自定义对象转换为基类型

除了支持基类型之间的转换外，Convert 方法还支持将任何自定义类型转换为任何基类型。 为此，自定义类型必须实现 IConvertible 接口，该接口定义用于将实现类型转换为每个基类型的方法。 特定类型不支持的转换会引发 InvalidCastException。

向 ChangeType 方法传递自定义类型作为其第一个参数时，或者在调用 Convert.ToType 方法（如 Convert.ToInt32(Object) 或 Convert.ToDouble(Object, IFormatProvider)）并向其传递自定义类型的实例作为其第一个参数时，Convert 方法反过来会调用自定义类型的 IConvertible 实现以执行转换。 有关更多信息，请参见 .NET Framework 中的类型转换。

区域性特定的格式设置信息

所有基类型转换方法和 ChangeType 方法都包括具有类型为 IFormatProvider 的参数的重载。 例如，Convert.ToBoolean 方法具有下面两个重载：

Convert.ToBoolean(Object, IFormatProvider)

Convert.ToBoolean(String, IFormatProvider)

IFormatProvider 参数可以提供区域性特定的格式设置信息以帮助转换过程。 但是，大多数基类型转换方法忽略了该参数。 只有下列基类型转换方法使用该参数：

将值转换为数值类型的方法。 IFormatProvider 参数由具有类型为 String 和 IFormatProvider 的参数的重载使用。 它也由具有类型为 Object 和 IFormatProvider 的参数的重载使用（如果对象的运行时类型为 String）。

将值转换为日期和时间的方法。 IFormatProvider 参数由具有类型为 String 和 IFormatProvider 的参数的重载使用。 它也由具有类型为 Object 和 IFormatProvider 的参数的重载使用（如果对象的运行时类型为 String）。

包含 IFormatProvider 参数并将数字值转换为字符串或将 DateTime 值转换为字符串的 Convert.ToString 重载。

但是，实现 IConvertible 的任何用户定义类型都可以使用 IFormatProvider 参数。

其他转换方法

有一组方法可支持字节数组与 String 或由 base 64 数字字符组成的 Unicode 字符数组之间的转换。 表示为以 64 为基的数字的数据可以很容易地通过只能传输 7 位字符的数据信道进行传送。

继承层次结构

System.Object

System.Convert

命名空间

namespace: System

程序集: mscorlib（在 mscorlib.dll 中）

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

版本信息

.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 系统要求。

C# 文件及文件夹操作

C# 文件操作

C# 文件夹操作