Convert 类

定义

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

public ref class Convert abstract sealed
public ref class Convert sealed
public static class Convert
public sealed class Convert
type Convert = class
Public Class Convert
Public NotInheritable Class Convert
继承
Convert

示例

下面的示例演示类中的Convert一些转换方法,包括ToInt32ToBooleanToString

double dNumber = 23.15;

try {
    // Returns 23
    int    iNumber = System.Convert.ToInt32(dNumber);
}
catch (System.OverflowException) {
    System.Console.WriteLine(
                "Overflow in double to int conversion.");
}
// Returns True
bool   bNumber = System.Convert.ToBoolean(dNumber);

// Returns "23.15"
string strNumber = System.Convert.ToString(dNumber);

try {
    // Returns '2'
    char chrNumber = System.Convert.ToChar(strNumber[0]);
}
catch (System.ArgumentNullException) {
    System.Console.WriteLine("String is null");
}
catch (System.FormatException) {
    System.Console.WriteLine("String length is greater than 1.");
}

// System.Console.ReadLine() returns a string and it
// must be converted.
int newInteger = 0;
try {
    System.Console.WriteLine("Enter an integer:");
    newInteger = System.Convert.ToInt32(
                        System.Console.ReadLine());
}
catch (System.ArgumentNullException) {
    System.Console.WriteLine("String is null.");
}
catch (System.FormatException) {
    System.Console.WriteLine("String does not consist of an " +
                    "optional sign followed by a series of digits.");
}
catch (System.OverflowException) {
    System.Console.WriteLine(
    "Overflow in string to int conversion.");
}

System.Console.WriteLine("Your integer as a double is {0}",
                         System.Convert.ToDouble(newInteger));
let dNumber = 23.15

try
    // Returns 23
    Convert.ToInt32 dNumber
    |> ignore
with :? OverflowException ->
    printfn "Overflow in double to int conversion."
// Returns True
let bNumber = System.Convert.ToBoolean dNumber

// Returns "23.15"
let strNumber = System.Convert.ToString dNumber

try
    // Returns '2'
    System.Convert.ToChar strNumber[0]
    |> ignore
with
| :? ArgumentNullException ->
    printfn "String is null"
| :? FormatException ->
    printfn "String length is greater than 1."

// System.Console.ReadLine() returns a string and it
// must be converted.
let newInteger =
    try
        printfn "Enter an integer:"
        System.Convert.ToInt32(Console.ReadLine())
    with
    | :? ArgumentNullException ->
        printfn "String is null."
        0
    | :? FormatException ->
        printfn "String does not consist of an optional sign followed by a series of digits."
        0
    | :? OverflowException ->
        printfn "Overflow in string to int conversion."
        0

printfn $"Your integer as a double is {System.Convert.ToDouble newInteger}"
Dim dNumber As Double
dNumber = 23.15

Try
   ' Returns 23
   Dim iNumber As Integer
   iNumber = System.Convert.ToInt32(dNumber)
Catch exp As System.OverflowException
   System.Console.WriteLine("Overflow in double to int conversion.")
End Try

' Returns True
Dim bNumber As Boolean
bNumber = System.Convert.ToBoolean(dNumber)

' Returns "23.15"
Dim strNumber As String
strNumber = System.Convert.ToString(dNumber)

Try
   ' Returns '2'
   Dim chrNumber As Char
   chrNumber = System.Convert.ToChar(strNumber.Chars(1))
Catch exp As System.ArgumentNullException
   System.Console.WriteLine("String is null.")
Catch exp As System.FormatException
   System.Console.WriteLine("String length is greater than 1.")
End Try

' System.Console.ReadLine() returns a string and it
' must be converted.
Dim newInteger As Integer
newInteger = 0
Try
   System.Console.WriteLine("Enter an integer:")
   newInteger = System.Convert.ToInt32(System.Console.ReadLine())
Catch exp As System.ArgumentNullException
   System.Console.WriteLine("String is null.")
Catch exp As System.FormatException
   System.Console.WriteLine("String does not consist of an " + _
       "optional sign followed by a series of digits.")
Catch exp As System.OverflowException
   System.Console.WriteLine("Overflow in string to int conversion.")
End Try

System.Console.WriteLine("Your integer as a double is {0}", _
                         System.Convert.ToDouble(newInteger))

注解

静态 Convert 类包含的方法主要用于支持在 .NET 中进行与基数据类型之间的转换。 支持的基类型包括Boolean:、Char、、SByteByteInt16Int32Int64UInt16、、UInt32、、UInt64、、Single、、 DoubleDecimalDateTimeString。 此外,该 Convert 类还包括支持其他类型的转换的方法。

基本类型之间的转换

存在转换方法,用于将每个基类型转换为其他每个基类型。 但是,对特定转换方法的实际调用可能会产生五个结果之一,具体取决于运行时基类型和目标基类型的值。 这五个结果包括:

  • 不进行转换。 当尝试将类型转换为自身时(例如,调用 Convert.ToInt32(Int32),并使用类型为 Int32 的参数),将发生这种情况。 在这种情况下,该方法只返回原始类型的实例。

  • InvalidCastException。 不支持特定转换时,会出现这种情况。 针对以下转换引发了 InvalidCastException

  • FormatException。 当尝试将字符串值转换为任何其他基类型时,如果转换失败,通常是因为字符串格式不正确。 针对以下转换引发了异常:

    • 要转换为值的 Boolean 字符串不等于 Boolean.TrueStringBoolean.FalseString
    • 要转换为值的 Char 字符串由多个字符组成。
    • 要转换为任何数值类型的字符串无法识别为有效数字。
    • 要转换为 DateTime 的字符串无法识别为有效的日期和时间值。
  • 成功转换。 对于前面结果中未列出的两种不同的基类型之间的转换,所有扩大转换以及不会导致数据丢失的所有缩小转换都将成功,并且该方法将返回目标基类型的值。

  • OverflowException。 当缩小转换会导致数据丢失时,会出现这种情况。 例如,尝试将值为 10000 的 Int32 实例转换为 Byte 类型会引发 OverflowException 异常,因为 10000 超出了 Byte 数据类型的范围。

如果数值类型的转换导致精度损失(即丢失一些最小有效位数),则不会引发异常。 但是,如果结果大于特定转换方法的返回值类型可以表示,则会引发异常。

例如,当某个 Double 转换为 a Single时,可能会丢失精度,但不会引发异常。 但是,如果大小 Double 过大而无法由 a Single表示,则会引发溢出异常。

非十进制数

此类 Convert 包括静态方法,可以调用这些方法将整型值转换为非十进制字符串表示形式,并将表示非十进制数的字符串转换为整型值。 每个转换方法都包含一个 base 参数,用于指定数字系统;二进制(base 2)、八进制(base 8)和十六进制(base 16),以及十进制(base 10)。 有一组方法可将每个符合 CLS 的基元整型类型转换为字符串,以及将字符串转换为每个基元整型类型的方法:

以下示例将 Int16.MaxValue 的值转换为所有支持的数值格式的字符串。 然后,它将字符串值转换回一个 Int16 值。

using System;

public class Example
{
   public static void Main()
   {
      int[] baseValues = { 2, 8, 10, 16 };
      short value = Int16.MaxValue;
      foreach (var baseValue in baseValues) {
         String s = Convert.ToString(value, baseValue);
         short value2 = Convert.ToInt16(s, baseValue);

         Console.WriteLine("{0} --> {1} (base {2}) --> {3}",
                           value, s, baseValue, value2);
      }
   }
}
// The example displays the following output:
//     32767 --> 111111111111111 (base 2) --> 32767
//     32767 --> 77777 (base 8) --> 32767
//     32767 --> 32767 (base 10) --> 32767
//     32767 --> 7fff (base 16) --> 32767
open System

let baseValues = [ 2; 8; 10; 16 ]
let value = Int16.MaxValue
for baseValue in baseValues do
    let s = Convert.ToString(value, baseValue)
    let value2 = Convert.ToInt16(s, baseValue)
    printfn $"{value} --> {s} (base {baseValue}) --> {value2}"

// The example displays the following output:
//     32767 --> 111111111111111 (base 2) --> 32767
//     32767 --> 77777 (base 8) --> 32767
//     32767 --> 32767 (base 10) --> 32767
//     32767 --> 7fff (base 16) --> 32767
Module Example2
    Public Sub Main()
        Dim baseValues() As Integer = {2, 8, 10, 16}
        Dim value As Short = Int16.MaxValue
        For Each baseValue In baseValues
            Dim s As String = Convert.ToString(value, baseValue)
            Dim value2 As Short = Convert.ToInt16(s, baseValue)

            Console.WriteLine("{0} --> {1} (base {2}) --> {3}",
                           value, s, baseValue, value2)
        Next
    End Sub
End Module
' The example displays the following output:
'     32767 --> 111111111111111 (base 2) --> 32767
'     32767 --> 77777 (base 8) --> 32767
'     32767 --> 32767 (base 10) --> 32767
'     32767 --> 7fff (base 16) --> 32767

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

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

ChangeType方法在被传递自定义类型作为其第一个参数时,或在调用Convert.ToType方法(例如Convert.ToInt32(Object)Convert.ToDouble(Object, IFormatProvider))并传递自定义类型的实例作为其第一个参数时,该Convert方法会调用自定义类型的IConvertible实现来执行转换。 有关详细信息,请参阅 .NET 中的类型转换

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

所有基类型转换方法和 ChangeType 方法都包含具有类型 IFormatProvider参数的重载。 例如,Convert.ToBoolean 方法具有以下两个重载:

IFormatProvider 参数可以提供文化特定的格式设置信息,以协助转换过程。 但是,大多数基类型转换方法都会忽略它。 它仅由以下基类型转换方法使用。 如果将 nullIFormatProvider 参数传递给这些方法,则使用表示当前区域性的 CultureInfo 对象。

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

Base64 编码

Base64 编码将二进制数据转换为字符串。 可以通过只能传输 7 位字符的数据通道轻松传达以 base-64 数字表示的数据。 该 Convert 类包括以下支持 Base64 编码的方法:一组方法支持在字节数组与由 Base64 数字字符组成的 Unicode 字符数组之间进行转换或在字节数组和 String 之间进行转换。

其他常见转换

可以使用其他 .NET 类来执行类的 Convert 静态方法不支持的某些转换。 这些包括:

  • 转换为字节数组

    BitConverter 类提供将基元数值类型(包括 Boolean)转换为字节数组和从字节数组转换回基元数据类型的方法。

  • 字符编码和解码

    Encoding 及其派生类(如 UnicodeEncodingUTF8Encoding)提供对字符数组或字符串进行编码的方法(即,将其转换为特定编码中的字节数组),以及解码编码的字节数组(即将字节数组转换回 UTF16 编码的 Unicode 字符)。 有关详细信息,请参阅 .NET 中的字符编码。

字段

名称 说明
DBNull

一个常量,表示不存在数据的数据库列;即数据库 null。

方法

名称 说明
ChangeType(Object, Type, IFormatProvider)

返回一个指定类型的对象,其值等效于指定的对象。 参数提供区域性特定的格式设置信息。

ChangeType(Object, Type)

返回指定类型的对象,其值等效于指定对象。

ChangeType(Object, TypeCode, IFormatProvider)

返回一个指定类型的对象,其值等效于指定的对象。 参数提供区域性特定的格式设置信息。

ChangeType(Object, TypeCode)

返回一个指定类型的对象,其值等效于指定的对象。

FromBase64CharArray(Char[], Int32, Int32)

将 Unicode 字符数组的子集(将二进制数据编码为 base-64 数字)转换为等效的 8 位无符号整数数组。 参数指定要转换的输入数组中的子集和元素数。

FromBase64String(String)

将将二进制数据编码为 base-64 数字的指定字符串转换为等效的 8 位无符号整数数组。

FromHexString(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32)

将将二进制数据编码为十六进制字符的 UTF-8 字符的范围转换为等效的 8 位无符号整数范围。

FromHexString(ReadOnlySpan<Byte>)

将二进制数据编码为十六进制字符的范围转换为等效的 8 位无符号整数数组。

FromHexString(ReadOnlySpan<Char>, Span<Byte>, Int32, Int32)

将二进制数据编码为十六进制字符的字符范围转换为等效的 8 位无符号整数范围。

FromHexString(ReadOnlySpan<Char>)

将二进制数据编码为十六进制字符的范围转换为等效的 8 位无符号整数数组。

FromHexString(String, Span<Byte>, Int32, Int32)

将二进制数据编码为十六进制字符的字符串转换为等效的 8 位无符号整数范围。

FromHexString(String)

将将二进制数据编码为十六进制字符的指定字符串转换为等效的 8 位无符号整数数组。

GetTypeCode(Object)

返回指定对象的值 TypeCode

IsDBNull(Object)

返回一个指示指定的对象是否为类型 DBNull

ToBase64CharArray(Byte[], Int32, Int32, Char[], Int32, Base64FormattingOptions)

将 8 位无符号整数数组的子集转换为使用 base-64 数字编码的 Unicode 字符数组的等效子集。 参数将子集指定为输入和输出数组中的偏移量、要转换的输入数组中的元素数以及是否在输出数组中插入换行符。

ToBase64CharArray(Byte[], Int32, Int32, Char[], Int32)

将 8 位无符号整数数组的子集转换为使用 base-64 数字编码的 Unicode 字符数组的等效子集。 参数将子集指定为输入和输出数组中的偏移量,以及要转换的输入数组中的元素数。

ToBase64String(Byte[], Base64FormattingOptions)

将一个由 8 位无符号整数组成的数组转换为其等效的字符串表示形式,该表示形式使用 base-64 位数字进行编码。 可以指定是否在返回值中插入换行符。

ToBase64String(Byte[], Int32, Int32, Base64FormattingOptions)

将 8 位无符号整数数组的子集转换为其用 base-64 数字编码的等效字符串表示形式。 参数将子集指定为输入数组中的偏移量、要转换的数组中的元素数以及是否在返回值中插入换行符。

ToBase64String(Byte[], Int32, Int32)

将 8 位无符号整数数组的子集转换为其用 base-64 数字编码的等效字符串表示形式。 参数将子集指定为输入数组中的偏移量以及要转换的数组中的元素数。

ToBase64String(Byte[])

将一个由 8 位无符号整数组成的数组转换为其等效的字符串表示形式,该表示形式使用 base-64 位数字进行编码。

ToBase64String(ReadOnlySpan<Byte>, Base64FormattingOptions)

将指定只读范围内的 8 位无符号整数转换为其等效的字符串表示形式,这些表示形式使用 base-64 数字进行编码。 可以选择指定是否在返回值中插入换行符。

ToBoolean(Boolean)

返回指定的布尔值;不执行实际转换。

ToBoolean(Byte)

将指定的 8 位无符号整数的值转换为等效的布尔值。

ToBoolean(Char)

调用此方法始终会 InvalidCastException引发 。

ToBoolean(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToBoolean(Decimal)

将指定的十进制数的值转换为等效的布尔值。

ToBoolean(Double)

将指定的双精度浮点数的值转换为等效的布尔值。

ToBoolean(Int16)

将指定的 16 位有符号整数的值转换为等效的布尔值。

ToBoolean(Int32)

将指定的 32 位有符号整数的值转换为等效的布尔值。

ToBoolean(Int64)

将指定的 64 位带符号整数的值转换为等效的布尔值。

ToBoolean(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为等效的布尔值。

ToBoolean(Object)

将指定对象的值转换为等效的布尔值。

ToBoolean(SByte)

将指定的 8 位带符号整数的值转换为等效的布尔值。

ToBoolean(Single)

将指定的单精度浮点数的值转换为等效的布尔值。

ToBoolean(String, IFormatProvider)

使用指定的区域性特定的格式设置信息将逻辑值的指定字符串表示形式转换为其布尔值。

ToBoolean(String)

将逻辑值的指定字符串表示形式转换为其布尔等效项。

ToBoolean(UInt16)

将指定的 16 位无符号整数的值转换为等效的布尔值。

ToBoolean(UInt32)

将指定的 32 位无符号整数的值转换为等效的布尔值。

ToBoolean(UInt64)

将指定的 64 位无符号整数的值转换为等效的布尔值。

ToByte(Boolean)

将指定的布尔值转换为等效的 8 位无符号整数。

ToByte(Byte)

返回指定的 8 位无符号整数;不执行实际转换。

ToByte(Char)

将指定的 Unicode 字符的值转换为等效的 8 位无符号整数。

ToByte(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToByte(Decimal)

将指定的十进制数的值转换为等效的 8 位无符号整数。

ToByte(Double)

将指定的双精度浮点数的值转换为等效的 8 位无符号整数。

ToByte(Int16)

将指定的 16 位有符号整数的值转换为等效的 8 位无符号整数。

ToByte(Int32)

将指定的 32 位有符号整数的值转换为等效的 8 位无符号整数。

ToByte(Int64)

将指定的 64 位有符号整数的值转换为等效的 8 位无符号整数。

ToByte(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为 8 位无符号整数。

ToByte(Object)

将指定对象的值转换为 8 位无符号整数。

ToByte(SByte)

将指定的 8 位有符号整数的值转换为等效的 8 位无符号整数。

ToByte(Single)

将指定的单精度浮点数的值转换为等效的 8 位无符号整数。

ToByte(String, IFormatProvider)

使用指定的区域性特定的格式设置信息,将数字的指定字符串表示形式转换为等效的 8 位无符号整数。

ToByte(String, Int32)

将指定基数中的数字的字符串表示形式转换为等效的 8 位无符号整数。

ToByte(String)

将数字的指定字符串表示形式转换为等效的 8 位无符号整数。

ToByte(UInt16)

将指定的 16 位无符号整数的值转换为等效的 8 位无符号整数。

ToByte(UInt32)

将指定的 32 位无符号整数的值转换为等效的 8 位无符号整数。

ToByte(UInt64)

将指定的 64 位无符号整数的值转换为等效的 8 位无符号整数。

ToChar(Boolean)

调用此方法始终会 InvalidCastException引发 。

ToChar(Byte)

将指定的 8 位无符号整数的值转换为其等效的 Unicode 字符。

ToChar(Char)

返回指定的 Unicode 字符值;不执行实际转换。

ToChar(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToChar(Decimal)

调用此方法始终会 InvalidCastException引发 。

ToChar(Double)

调用此方法始终会 InvalidCastException引发 。

ToChar(Int16)

将指定的 16 位带符号整数的值转换为其等效的 Unicode 字符。

ToChar(Int32)

将指定的 32 位带符号整数的值转换为其等效的 Unicode 字符。

ToChar(Int64)

将指定的 64 位带符号整数的值转换为其等效的 Unicode 字符。

ToChar(Object, IFormatProvider)

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

ToChar(Object)

将指定对象的值转换为 Unicode 字符。

ToChar(SByte)

将指定的 8 位带符号整数的值转换为其等效的 Unicode 字符。

ToChar(Single)

调用此方法始终会 InvalidCastException引发 。

ToChar(String, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定字符串的第一个字符转换为 Unicode 字符。

ToChar(String)

将指定字符串的第一个字符转换为 Unicode 字符。

ToChar(UInt16)

将指定的 16 位无符号整数的值转换为其等效的 Unicode 字符。

ToChar(UInt32)

将指定的 32 位无符号整数的值转换为其等效的 Unicode 字符。

ToChar(UInt64)

将指定的 64 位无符号整数的值转换为其等效的 Unicode 字符。

ToDateTime(Boolean)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(Byte)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(Char)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(DateTime)

返回指定的 DateTime 对象;不执行实际转换。

ToDateTime(Decimal)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(Double)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(Int16)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(Int32)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(Int64)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为 DateTime 对象。

ToDateTime(Object)

将指定对象的值转换为对象 DateTime

ToDateTime(SByte)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(Single)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(String, IFormatProvider)

使用指定的区域性特定的格式设置信息将数字的指定字符串表示形式转换为等效的日期和时间。

ToDateTime(String)

将日期和时间的指定字符串表示形式转换为等效的日期和时间值。

ToDateTime(UInt16)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(UInt32)

调用此方法始终会 InvalidCastException引发 。

ToDateTime(UInt64)

调用此方法始终会 InvalidCastException引发 。

ToDecimal(Boolean)

将指定的布尔值转换为等效的十进制数。

ToDecimal(Byte)

将指定的 8 位无符号整数的值转换为等效的小数。

ToDecimal(Char)

调用此方法始终会 InvalidCastException引发 。

ToDecimal(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToDecimal(Decimal)

返回指定的十进制数;不执行实际转换。

ToDecimal(Double)

将指定的双精度浮点数的值转换为等效的小数。

ToDecimal(Int16)

将指定的 16 位有符号整数的值转换为等效的小数。

ToDecimal(Int32)

将指定的 32 位有符号整数的值转换为等效的小数。

ToDecimal(Int64)

将指定的 64 位有符号整数的值转换为等效的十进制数。

ToDecimal(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为等效的十进制数。

ToDecimal(Object)

将指定对象的值转换为等效的十进制数。

ToDecimal(SByte)

将指定的 8 位有符号整数的值转换为等效的十进制数。

ToDecimal(Single)

将指定的单精度浮点数的值转换为等效的小数。

ToDecimal(String, IFormatProvider)

使用指定的区域性特定的格式设置信息将数字的指定字符串表示形式转换为等效的十进制数。

ToDecimal(String)

将数字的指定字符串表示形式转换为等效的小数。

ToDecimal(UInt16)

将指定的 16 位无符号整数的值转换为等效的小数。

ToDecimal(UInt32)

将指定的 32 位无符号整数的值转换为等效的小数。

ToDecimal(UInt64)

将指定的 64 位无符号整数的值转换为等效的小数。

ToDouble(Boolean)

将指定的布尔值转换为等效的双精度浮点数。

ToDouble(Byte)

将指定的 8 位无符号整数的值转换为等效的双精度浮点数。

ToDouble(Char)

调用此方法始终会 InvalidCastException引发 。

ToDouble(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToDouble(Decimal)

将指定十进制数的值转换为等效的双精度浮点数。

ToDouble(Double)

返回指定的双精度浮点数;不执行实际转换。

ToDouble(Int16)

将指定的 16 位有符号整数的值转换为等效的双精度浮点数。

ToDouble(Int32)

将指定的 32 位有符号整数的值转换为等效的双精度浮点数。

ToDouble(Int64)

将指定的 64 位带符号整数的值转换为等效的双精度浮点数。

ToDouble(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为双精度浮点数。

ToDouble(Object)

将指定对象的值转换为双精度浮点数。

ToDouble(SByte)

将指定的 8 位有符号整数的值转换为等效的双精度浮点数。

ToDouble(Single)

将指定的单精度浮点数的值转换为等效的双精度浮点数。

ToDouble(String, IFormatProvider)

使用指定的区域性特定的格式设置信息,将数字的指定字符串表示形式转换为等效的双精度浮点数。

ToDouble(String)

将数字的指定字符串表示形式转换为等效的双精度浮点数。

ToDouble(UInt16)

将指定的 16 位无符号整数的值转换为等效的双精度浮点数。

ToDouble(UInt32)

将指定的 32 位无符号整数的值转换为等效的双精度浮点数。

ToDouble(UInt64)

将指定的 64 位无符号整数的值转换为等效的双精度浮点数。

ToHexString(Byte[], Int32, Int32)

将 8 位无符号整数数组的子集转换为其用大写十六进制字符编码的等效字符串表示形式。 参数将子集指定为输入数组中的偏移量和要转换的数组中的元素数。

ToHexString(Byte[])

将一个由 8 位无符号整数构成的数组转换为其等效的字符串表示形式,该表示形式使用大写十六进制字符进行编码。

ToHexString(ReadOnlySpan<Byte>)

将 8 位无符号整数的范围转换为其用大写十六进制字符编码的等效字符串表示形式。

ToHexStringLower(Byte[], Int32, Int32)

将 8 位无符号整数数组的子集转换为其用小写十六进制字符编码的等效字符串表示形式。 参数将子集指定为输入数组中的偏移量和要转换的数组中的元素数。

ToHexStringLower(Byte[])

将 8 位无符号整数数组转换为其等效的字符串表示形式,该表示形式使用小写十六进制字符进行编码。

ToHexStringLower(ReadOnlySpan<Byte>)

将 8 位无符号整数的范围转换为其用小写十六进制字符编码的等效字符串表示形式。

ToInt16(Boolean)

将指定的布尔值转换为等效的 16 位带符号整数。

ToInt16(Byte)

将指定的 8 位无符号整数的值转换为等效的 16 位有符号整数。

ToInt16(Char)

将指定的 Unicode 字符的值转换为等效的 16 位有符号整数。

ToInt16(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToInt16(Decimal)

将指定的十进制数的值转换为等效的 16 位有符号整数。

ToInt16(Double)

将指定的双精度浮点数的值转换为等效的 16 位带符号整数。

ToInt16(Int16)

返回指定的 16 位有符号整数;不执行实际转换。

ToInt16(Int32)

将指定的 32 位有符号整数的值转换为等效的 16 位有符号整数。

ToInt16(Int64)

将指定的 64 位有符号整数的值转换为等效的 16 位有符号整数。

ToInt16(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为 16 位有符号整数。

ToInt16(Object)

将指定对象的值转换为 16 位有符号整数。

ToInt16(SByte)

将指定的 8 位有符号整数的值转换为等效的 16 位有符号整数。

ToInt16(Single)

将指定的单精度浮点数的值转换为等效的 16 位有符号整数。

ToInt16(String, IFormatProvider)

使用指定的区域性特定的格式设置信息,将数字的指定字符串表示形式转换为等效的 16 位带符号整数。

ToInt16(String, Int32)

将指定基数中的数字的字符串表示形式转换为等效的 16 位有符号整数。

ToInt16(String)

将数字的指定字符串表示形式转换为等效的 16 位带符号整数。

ToInt16(UInt16)

将指定的 16 位无符号整数的值转换为等效的 16 位有符号整数。

ToInt16(UInt32)

将指定的 32 位无符号整数的值转换为等效的 16 位有符号整数。

ToInt16(UInt64)

将指定的 64 位无符号整数的值转换为等效的 16 位有符号整数。

ToInt32(Boolean)

将指定的布尔值转换为等效的 32 位有符号整数。

ToInt32(Byte)

将指定的 8 位无符号整数的值转换为等效的 32 位有符号整数。

ToInt32(Char)

将指定的 Unicode 字符的值转换为等效的 32 位带符号整数。

ToInt32(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToInt32(Decimal)

将指定的十进制数的值转换为等效的 32 位有符号整数。

ToInt32(Double)

将指定的双精度浮点数的值转换为等效的 32 位有符号整数。

ToInt32(Int16)

将指定的 16 位有符号整数的值转换为等效的 32 位有符号整数。

ToInt32(Int32)

返回指定的 32 位有符号整数;不执行实际转换。

ToInt32(Int64)

将指定的 64 位有符号整数的值转换为等效的 32 位有符号整数。

ToInt32(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为 32 位有符号整数。

ToInt32(Object)

将指定对象的值转换为 32 位有符号整数。

ToInt32(SByte)

将指定的 8 位有符号整数的值转换为等效的 32 位有符号整数。

ToInt32(Single)

将指定的单精度浮点数的值转换为等效的 32 位带符号整数。

ToInt32(String, IFormatProvider)

使用指定的区域性特定的格式设置信息,将数字的指定字符串表示形式转换为等效的 32 位有符号整数。

ToInt32(String, Int32)

将指定基数中的数字的字符串表示形式转换为等效的 32 位有符号整数。

ToInt32(String)

将数字的指定字符串表示形式转换为等效的 32 位有符号整数。

ToInt32(UInt16)

将指定的 16 位无符号整数的值转换为等效的 32 位有符号整数。

ToInt32(UInt32)

将指定的 32 位无符号整数的值转换为等效的 32 位有符号整数。

ToInt32(UInt64)

将指定的 64 位无符号整数的值转换为等效的 32 位有符号整数。

ToInt64(Boolean)

将指定的布尔值转换为等效的 64 位带符号整数。

ToInt64(Byte)

将指定的 8 位无符号整数的值转换为等效的 64 位有符号整数。

ToInt64(Char)

将指定的 Unicode 字符的值转换为等效的 64 位带符号整数。

ToInt64(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToInt64(Decimal)

将指定的十进制数的值转换为等效的 64 位带符号整数。

ToInt64(Double)

将指定的双精度浮点数的值转换为等效的 64 位带符号整数。

ToInt64(Int16)

将指定的 16 位有符号整数的值转换为等效的 64 位有符号整数。

ToInt64(Int32)

将指定的 32 位有符号整数的值转换为等效的 64 位有符号整数。

ToInt64(Int64)

返回指定的 64 位有符号整数;不执行实际转换。

ToInt64(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为 64 位有符号整数。

ToInt64(Object)

将指定对象的值转换为 64 位带符号整数。

ToInt64(SByte)

将指定的 8 位有符号整数的值转换为等效的 64 位有符号整数。

ToInt64(Single)

将指定的单精度浮点数的值转换为等效的 64 位带符号整数。

ToInt64(String, IFormatProvider)

使用指定的区域性特定的格式设置信息,将数字的指定字符串表示形式转换为等效的 64 位带符号整数。

ToInt64(String, Int32)

将指定基数中的数字的字符串表示形式转换为等效的 64 位带符号整数。

ToInt64(String)

将数字的指定字符串表示形式转换为等效的 64 位带符号整数。

ToInt64(UInt16)

将指定的 16 位无符号整数的值转换为等效的 64 位有符号整数。

ToInt64(UInt32)

将指定的 32 位无符号整数的值转换为等效的 64 位带符号整数。

ToInt64(UInt64)

将指定的 64 位无符号整数的值转换为等效的 64 位有符号整数。

ToSByte(Boolean)

将指定的布尔值转换为等效的 8 位带符号整数。

ToSByte(Byte)

将指定的 8 位无符号整数的值转换为等效的 8 位有符号整数。

ToSByte(Char)

将指定的 Unicode 字符的值转换为等效的 8 位带符号整数。

ToSByte(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToSByte(Decimal)

将指定的十进制数的值转换为等效的 8 位有符号整数。

ToSByte(Double)

将指定的双精度浮点数的值转换为等效的 8 位带符号整数。

ToSByte(Int16)

将指定的 16 位有符号整数的值转换为等效的 8 位有符号整数。

ToSByte(Int32)

将指定的 32 位有符号整数的值转换为等效的 8 位有符号整数。

ToSByte(Int64)

将指定的 64 位有符号整数的值转换为等效的 8 位有符号整数。

ToSByte(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为 8 位有符号整数。

ToSByte(Object)

将指定对象的值转换为 8 位有符号整数。

ToSByte(SByte)

返回指定的 8 位有符号整数;不执行实际转换。

ToSByte(Single)

将指定的单精度浮点数的值转换为等效的 8 位带符号整数。

ToSByte(String, IFormatProvider)

使用指定的区域性特定的格式设置信息,将数字的指定字符串表示形式转换为等效的 8 位带符号整数。

ToSByte(String, Int32)

将指定基数中的数字的字符串表示形式转换为等效的 8 位带符号整数。

ToSByte(String)

将数字的指定字符串表示形式转换为等效的 8 位有符号整数。

ToSByte(UInt16)

将指定的 16 位无符号整数的值转换为等效的 8 位有符号整数。

ToSByte(UInt32)

将指定的 32 位无符号整数的值转换为等效的 8 位有符号整数。

ToSByte(UInt64)

将指定的 64 位无符号整数的值转换为等效的 8 位有符号整数。

ToSingle(Boolean)

将指定的布尔值转换为等效的单精度浮点数。

ToSingle(Byte)

将指定的 8 位无符号整数的值转换为等效的单精度浮点数。

ToSingle(Char)

调用此方法始终会 InvalidCastException引发 。

ToSingle(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToSingle(Decimal)

将指定的十进制数的值转换为等效的单精度浮点数。

ToSingle(Double)

将指定的双精度浮点数的值转换为等效的单精度浮点数。

ToSingle(Int16)

将指定的 16 位有符号整数的值转换为等效的单精度浮点数。

ToSingle(Int32)

将指定的 32 位有符号整数的值转换为等效的单精度浮点数。

ToSingle(Int64)

将指定的 64 位有符号整数的值转换为等效的单精度浮点数。

ToSingle(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为单精度浮点数。

ToSingle(Object)

将指定对象的值转换为单精度浮点数。

ToSingle(SByte)

将指定的 8 位有符号整数的值转换为等效的单精度浮点数。

ToSingle(Single)

返回指定的单精度浮点数;不执行实际转换。

ToSingle(String, IFormatProvider)

使用指定的区域性特定的格式设置信息,将数字的指定字符串表示形式转换为等效的单精度浮点数。

ToSingle(String)

将数字的指定字符串表示形式转换为等效的单精度浮点数。

ToSingle(UInt16)

将指定的 16 位无符号整数的值转换为等效的单精度浮点数。

ToSingle(UInt32)

将指定的 32 位无符号整数的值转换为等效的单精度浮点数。

ToSingle(UInt64)

将指定的 64 位无符号整数的值转换为等效的单精度浮点数。

ToString(Boolean, IFormatProvider)

将指定的布尔值转换为其等效的字符串表示形式。

ToString(Boolean)

将指定的布尔值转换为其等效的字符串表示形式。

ToString(Byte, IFormatProvider)

使用指定的区域性特定的格式设置信息,将指定的 8 位无符号整数的值转换为其等效的字符串表示形式。

ToString(Byte, Int32)

将 8 位无符号整数的值转换为指定基中的等效字符串表示形式。

ToString(Byte)

将指定的 8 位无符号整数的值转换为其等效的字符串表示形式。

ToString(Char, IFormatProvider)

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

ToString(Char)

将指定的 Unicode 字符的值转换为其等效的字符串表示形式。

ToString(DateTime, IFormatProvider)

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

ToString(DateTime)

将指定的 DateTime 值转换为其等效的字符串表示形式。

ToString(Decimal, IFormatProvider)

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

ToString(Decimal)

将指定十进制数的值转换为其等效的字符串表示形式。

ToString(Double, IFormatProvider)

将指定的双精度浮点数的值转换为其等效的字符串表示形式。

ToString(Double)

将指定的双精度浮点数的值转换为其等效的字符串表示形式。

ToString(Int16, IFormatProvider)

使用指定的区域性特定的格式设置信息,将指定的 16 位带符号整数的值转换为其等效的字符串表示形式。

ToString(Int16, Int32)

将 16 位带符号整数的值转换为指定基中的等效字符串表示形式。

ToString(Int16)

将指定的 16 位有符号整数的值转换为其等效的字符串表示形式。

ToString(Int32, IFormatProvider)

使用指定的区域性特定的格式设置信息,将指定的 32 位带符号整数的值转换为其等效的字符串表示形式。

ToString(Int32, Int32)

将 32 位有符号整数的值转换为指定基中的等效字符串表示形式。

ToString(Int32)

将指定的 32 位有符号整数的值转换为其等效的字符串表示形式。

ToString(Int64, IFormatProvider)

使用指定的区域性特定的格式设置信息,将指定的 64 位带符号整数的值转换为其等效的字符串表示形式。

ToString(Int64, Int32)

将 64 位带符号整数的值转换为指定基中的等效字符串表示形式。

ToString(Int64)

将指定的 64 位带符号整数的值转换为其等效的字符串表示形式。

ToString(Object, IFormatProvider)

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

ToString(Object)

将指定对象的值转换为其等效的字符串表示形式。

ToString(SByte, IFormatProvider)

使用指定的区域性特定的格式设置信息,将指定的 8 位带符号整数的值转换为其等效的字符串表示形式。

ToString(SByte)

将指定的 8 位有符号整数的值转换为其等效的字符串表示形式。

ToString(Single, IFormatProvider)

使用指定的区域性特定的格式设置信息,将指定的单精度浮点数的值转换为其等效的字符串表示形式。

ToString(Single)

将指定的单精度浮点数的值转换为其等效的字符串表示形式。

ToString(String, IFormatProvider)

返回指定的字符串实例;不执行实际转换。

ToString(String)

返回指定的字符串实例;不执行实际转换。

ToString(UInt16, IFormatProvider)

使用指定的区域性特定的格式设置信息,将指定的 16 位无符号整数的值转换为其等效的字符串表示形式。

ToString(UInt16)

将指定的 16 位无符号整数的值转换为其等效的字符串表示形式。

ToString(UInt32, IFormatProvider)

使用指定的区域性特定的格式设置信息,将指定的 32 位无符号整数的值转换为其等效的字符串表示形式。

ToString(UInt32)

将指定的 32 位无符号整数的值转换为其等效的字符串表示形式。

ToString(UInt64, IFormatProvider)

使用指定的区域性特定的格式设置信息,将指定的 64 位无符号整数的值转换为其等效的字符串表示形式。

ToString(UInt64)

将指定的 64 位无符号整数的值转换为其等效的字符串表示形式。

ToUInt16(Boolean)

将指定的布尔值转换为等效的 16 位无符号整数。

ToUInt16(Byte)

将指定的 8 位无符号整数的值转换为等效的 16 位无符号整数。

ToUInt16(Char)

将指定的 Unicode 字符的值转换为等效的 16 位无符号整数。

ToUInt16(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToUInt16(Decimal)

将指定的十进制数的值转换为等效的 16 位无符号整数。

ToUInt16(Double)

将指定的双精度浮点数的值转换为等效的 16 位无符号整数。

ToUInt16(Int16)

将指定的 16 位有符号整数的值转换为等效的 16 位无符号整数。

ToUInt16(Int32)

将指定的 32 位有符号整数的值转换为等效的 16 位无符号整数。

ToUInt16(Int64)

将指定的 64 位有符号整数的值转换为等效的 16 位无符号整数。

ToUInt16(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为 16 位无符号整数。

ToUInt16(Object)

将指定对象的值转换为 16 位无符号整数。

ToUInt16(SByte)

将指定的 8 位有符号整数的值转换为等效的 16 位无符号整数。

ToUInt16(Single)

将指定的单精度浮点数的值转换为等效的 16 位无符号整数。

ToUInt16(String, IFormatProvider)

使用指定的区域性特定的格式设置信息,将数字的指定字符串表示形式转换为等效的 16 位无符号整数。

ToUInt16(String, Int32)

将指定基数中的数字的字符串表示形式转换为等效的 16 位无符号整数。

ToUInt16(String)

将数字的指定字符串表示形式转换为等效的 16 位无符号整数。

ToUInt16(UInt16)

返回指定的 16 位无符号整数;不执行实际转换。

ToUInt16(UInt32)

将指定的 32 位无符号整数的值转换为等效的 16 位无符号整数。

ToUInt16(UInt64)

将指定的 64 位无符号整数的值转换为等效的 16 位无符号整数。

ToUInt32(Boolean)

将指定的布尔值转换为等效的 32 位无符号整数。

ToUInt32(Byte)

将指定的 8 位无符号整数的值转换为等效的 32 位无符号整数。

ToUInt32(Char)

将指定的 Unicode 字符的值转换为等效的 32 位无符号整数。

ToUInt32(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToUInt32(Decimal)

将指定的十进制数的值转换为等效的 32 位无符号整数。

ToUInt32(Double)

将指定的双精度浮点数的值转换为等效的 32 位无符号整数。

ToUInt32(Int16)

将指定的 16 位有符号整数的值转换为等效的 32 位无符号整数。

ToUInt32(Int32)

将指定的 32 位有符号整数的值转换为等效的 32 位无符号整数。

ToUInt32(Int64)

将指定的 64 位有符号整数的值转换为等效的 32 位无符号整数。

ToUInt32(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为 32 位无符号整数。

ToUInt32(Object)

将指定对象的值转换为 32 位无符号整数。

ToUInt32(SByte)

将指定的 8 位有符号整数的值转换为等效的 32 位无符号整数。

ToUInt32(Single)

将指定的单精度浮点数的值转换为等效的 32 位无符号整数。

ToUInt32(String, IFormatProvider)

使用指定的区域性特定的格式设置信息,将数字的指定字符串表示形式转换为等效的 32 位无符号整数。

ToUInt32(String, Int32)

将指定基数中的数字的字符串表示形式转换为等效的 32 位无符号整数。

ToUInt32(String)

将数字的指定字符串表示形式转换为等效的 32 位无符号整数。

ToUInt32(UInt16)

将指定的 16 位无符号整数的值转换为等效的 32 位无符号整数。

ToUInt32(UInt32)

返回指定的 32 位无符号整数;不执行实际转换。

ToUInt32(UInt64)

将指定的 64 位无符号整数的值转换为等效的 32 位无符号整数。

ToUInt64(Boolean)

将指定的布尔值转换为等效的 64 位无符号整数。

ToUInt64(Byte)

将指定的 8 位无符号整数的值转换为等效的 64 位无符号整数。

ToUInt64(Char)

将指定的 Unicode 字符的值转换为等效的 64 位无符号整数。

ToUInt64(DateTime)

调用此方法始终会 InvalidCastException引发 。

ToUInt64(Decimal)

将指定的十进制数的值转换为等效的 64 位无符号整数。

ToUInt64(Double)

将指定的双精度浮点数的值转换为等效的 64 位无符号整数。

ToUInt64(Int16)

将指定的 16 位有符号整数的值转换为等效的 64 位无符号整数。

ToUInt64(Int32)

将指定的 32 位有符号整数的值转换为等效的 64 位无符号整数。

ToUInt64(Int64)

将指定的 64 位有符号整数的值转换为等效的 64 位无符号整数。

ToUInt64(Object, IFormatProvider)

使用指定的区域性特定的格式设置信息将指定对象的值转换为 64 位无符号整数。

ToUInt64(Object)

将指定对象的值转换为 64 位无符号整数。

ToUInt64(SByte)

将指定的 8 位有符号整数的值转换为等效的 64 位无符号整数。

ToUInt64(Single)

将指定的单精度浮点数的值转换为等效的 64 位无符号整数。

ToUInt64(String, IFormatProvider)

使用指定的区域性特定的格式设置信息将数字的指定字符串表示形式转换为等效的 64 位无符号整数。

ToUInt64(String, Int32)

将指定基数中的数字的字符串表示形式转换为等效的 64 位无符号整数。

ToUInt64(String)

将数字的指定字符串表示形式转换为等效的 64 位无符号整数。

ToUInt64(UInt16)

将指定的 16 位无符号整数的值转换为等效的 64 位无符号整数。

ToUInt64(UInt32)

将指定的 32 位无符号整数的值转换为等效的 64 位无符号整数。

ToUInt64(UInt64)

返回指定的 64 位无符号整数;不执行实际转换。

TryFromBase64Chars(ReadOnlySpan<Char>, Span<Byte>, Int32)

尝试将包含字符串表示形式的指定范围转换为 8 位无符号整数范围,该表示形式用 base-64 位数字进行编码。

TryFromBase64String(String, Span<Byte>, Int32)

尝试将用 base-64 数字编码的指定字符串表示形式转换为 8 位无符号整数的跨度。

TryToBase64Chars(ReadOnlySpan<Byte>, Span<Char>, Int32, Base64FormattingOptions)

尝试将指定只读范围内的 8 位无符号整数转换为其等效的字符串表示形式,该表示形式使用 base-64 数字进行编码。 可以选择指定是否在返回值中插入换行符。

TryToHexString(ReadOnlySpan<Byte>, Span<Byte>, Int32)

将 8 位无符号整数的范围转换为其等效的 UTF-8 范围表示形式,该表示形式使用大写十六进制字符进行编码。

TryToHexString(ReadOnlySpan<Byte>, Span<Char>, Int32)

将 8 位无符号整数的范围转换为其用大写十六进制字符编码的等效范围表示形式。

TryToHexStringLower(ReadOnlySpan<Byte>, Span<Byte>, Int32)

将 8 位无符号整数的范围转换为其等效的 UTF-8 范围表示形式,该表示形式使用小写十六进制字符进行编码。

TryToHexStringLower(ReadOnlySpan<Byte>, Span<Char>, Int32)

将 8 位无符号整数的范围转换为其用小写十六进制字符编码的等效范围表示形式。

适用于

另请参阅