This topic has not yet been rated - Rate this topic

Convert Class

April 12, 2014

Converts a base data type to another base data type.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
public static class Convert

The Convert type exposes the following members.

  NameDescription
Public methodStatic memberChangeType(Object, Type)Returns an object of the specified type and whose value is equivalent to the specified object.
Public methodStatic memberChangeType(Object, Type, IFormatProvider)Returns an object of the specified type whose value is equivalent to the specified object. A parameter supplies culture-specific formatting information.
Public methodStatic memberChangeType(Object, TypeCode, IFormatProvider)Returns an object of the specified type whose value is equivalent to the specified object. A parameter supplies culture-specific formatting information.
Public methodStatic memberFromBase64CharArrayConverts a subset of a Unicode character array, which encodes binary data as base 64 digits, to an equivalent 8-bit unsigned integer array. Parameters specify the subset in the input array and the number of elements to convert.
Public methodStatic memberFromBase64StringConverts the specified String, which encodes binary data as base 64 digits, to an equivalent 8-bit unsigned integer array.
Public methodStatic memberGetTypeCodeReturns the TypeCode for the specified object.
Public methodStatic memberIsDBNullReturns an indication whether the specified object is of type DBNull.
Public methodStatic memberToBase64CharArrayConverts a subset of an 8-bit unsigned integer array to an equivalent subset of a Unicode character array encoded with base 64 digits. Parameters specify the subsets as offsets in the input and output arrays, and the number of elements in the input array to convert.
Public methodStatic memberToBase64String(Byte[])Converts an array of 8-bit unsigned integers to its equivalent String representation encoded with base 64 digits.
Public methodStatic memberToBase64String(Byte[], Int32, Int32)Converts a subset of an array of 8-bit unsigned integers to its equivalent String representation encoded with base 64 digits. Parameters specify the subset as an offset in the input array, and the number of elements in the array to convert.
Public methodStatic memberToBoolean(Boolean)Returns the specified Boolean value; no actual conversion is performed.
Public methodStatic memberToBoolean(Byte)Converts the value of the specified 8-bit unsigned integer to an equivalent Boolean value.
Public methodStatic memberToBoolean(Char)Calling this method always throws InvalidCastException.
Public methodStatic memberToBoolean(Decimal)Converts the value of the specified Decimal number to an equivalent Boolean value.
Public methodStatic memberToBoolean(Double)Converts the value of the specified double-precision floating point number to an equivalent Boolean value.
Public methodStatic memberToBoolean(Int16)Converts the value of the specified 16-bit signed integer to an equivalent Boolean value.
Public methodStatic memberToBoolean(Int32)Converts the value of the specified 32-bit signed integer to an equivalent Boolean value.
Public methodStatic memberToBoolean(Int64)Converts the value of the specified 64-bit signed integer to an equivalent Boolean value.
Public methodStatic memberToBoolean(Object)Converts the value of a specified Object to an equivalent Boolean value.
Public methodStatic memberToBoolean(SByte)Converts the value of the specified 8-bit signed integer to an equivalent Boolean value.
Public methodStatic memberToBoolean(Single)Converts the value of the specified single-precision floating point number to an equivalent Boolean value.
Public methodStatic memberToBoolean(String)Converts the specified String representation of a logical value to its Boolean equivalent.
Public methodStatic memberToBoolean(UInt16)Converts the value of the specified 16-bit unsigned integer to an equivalent Boolean value.
Public methodStatic memberToBoolean(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent Boolean value.
Public methodStatic memberToBoolean(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent Boolean value.
Public methodStatic memberToBoolean(Object, IFormatProvider)Converts the value of the specified Object to an equivalent Boolean value using the specified culture-specific formatting information.
Public methodStatic memberToBoolean(String, IFormatProvider)Converts the specified String representation of a logical value to its Boolean equivalent using the specified culture-specific formatting information.
Public methodStatic memberToByte(Boolean)Converts the value of the specified Boolean value to the equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(Byte)Returns the specified 8-bit unsigned integer; no actual conversion is performed.
Public methodStatic memberToByte(Char)Converts the value of the specified Unicode character to the equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(Decimal)Converts the value of the specified Decimal number to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(Double)Converts the value of the specified double-precision floating point number to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(Int16)Converts the value of the specified 16-bit signed integer to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(Int32)Converts the value of the specified 32-bit signed integer to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(Int64)Converts the value of the specified 64-bit signed integer to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(Object)Converts the value of the specified Object to an 8-bit unsigned integer.
Public methodStatic memberToByte(SByte)Converts the value of the specified 8-bit signed integer to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(Single)Converts the value of the specified single-precision floating point number to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(String)Converts the specified String representation of a number to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(UInt16)Converts the value of the specified 16-bit unsigned integer to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent 8-bit unsigned integer.
Public methodStatic memberToByte(Object, IFormatProvider)Converts the value of the specified Object to an 8-bit unsigned integer using the specified culture-specific formatting information.
Public methodStatic memberToByte(String, IFormatProvider)Converts the specified String representation of a number to an equivalent 8-bit unsigned integer using specified culture-specific formatting information.
Public methodStatic memberToByte(String, Int32)Converts the string representation of a number in a specified base to an equivalent 8-bit unsigned integer.
Public methodStatic memberToChar(Byte)Converts the value of the specified 8-bit unsigned integer to its equivalent Unicode character.
Public methodStatic memberToChar(Char)Returns the specified Unicode character value; no actual conversion is performed.
Public methodStatic memberToChar(Decimal)Calling this method always throws InvalidCastException.
Public methodStatic memberToChar(Double)Calling this method always throws InvalidCastException.
Public methodStatic memberToChar(Int16)Converts the value of the specified 16-bit signed integer to its equivalent Unicode character.
Public methodStatic memberToChar(Int32)Converts the value of the specified 32-bit signed integer to its equivalent Unicode character.
Public methodStatic memberToChar(Int64)Converts the value of the specified 64-bit signed integer to its equivalent Unicode character.
Public methodStatic memberToChar(Object)Converts the value of the specified Object to a Unicode character.
Public methodStatic memberToChar(SByte)Converts the value of the specified 8-bit signed integer to its equivalent Unicode character.
Public methodStatic memberToChar(Single)Calling this method always throws InvalidCastException.
Public methodStatic memberToChar(String)Converts the first character of a String to a Unicode character.
Public methodStatic memberToChar(UInt16)Converts the value of the specified 16-bit unsigned integer to its equivalent Unicode character.
Public methodStatic memberToChar(UInt32)Converts the value of the specified 32-bit unsigned integer to its equivalent Unicode character.
Public methodStatic memberToChar(UInt64)Converts the value of the specified 64-bit unsigned integer to its equivalent Unicode character.
Public methodStatic memberToChar(Object, IFormatProvider)Converts the value of the specified Object to its equivalent Unicode character using the specified culture-specific formatting information.
Public methodStatic memberToChar(String, IFormatProvider)Converts the first character of a String to a Unicode character using specified culture-specific formatting information.
Public methodStatic memberToDateTime(Object)Converts the value of the specified Object to a DateTime.
Public methodStatic memberToDateTime(String)Converts the specified String representation of a date and time to an equivalent DateTime.
Public methodStatic memberToDateTime(Object, IFormatProvider)Converts the value of the specified Object to a DateTime using the specified culture-specific formatting information.
Public methodStatic memberToDateTime(String, IFormatProvider)Converts the specified String representation of a number to an equivalent DateTime using the specified culture-specific formatting information.
Public methodStatic memberToDecimal(Boolean)Converts the value of the specified Boolean value to the equivalent Decimal number.
Public methodStatic memberToDecimal(Byte)Converts the value of the specified 8-bit unsigned integer to the equivalent Decimal number.
Public methodStatic memberToDecimal(Char)Calling this method always throws InvalidCastException.
Public methodStatic memberToDecimal(DateTime)Calling this method always throws InvalidCastException.
Public methodStatic memberToDecimal(Decimal)Returns the specified Decimal number; no actual conversion is performed.
Public methodStatic memberToDecimal(Double)Converts the value of the specified double-precision floating point number to an equivalent Decimal number.
Public methodStatic memberToDecimal(Int16)Converts the value of the specified 16-bit signed integer to an equivalent Decimal number.
Public methodStatic memberToDecimal(Int32)Converts the value of the specified 32-bit signed integer to an equivalent Decimal number.
Public methodStatic memberToDecimal(Int64)Converts the value of the specified 64-bit signed integer to an equivalent Decimal number.
Public methodStatic memberToDecimal(Object)Converts the value of the specified Object to a Decimal number.
Public methodStatic memberToDecimal(SByte)Converts the value of the specified 8-bit signed integer to the equivalent Decimal number.
Public methodStatic memberToDecimal(Single)Converts the value of the specified single-precision floating point number to the equivalent Decimal number.
Public methodStatic memberToDecimal(String)Converts the specified String representation of a number to an equivalent Decimal number.
Public methodStatic memberToDecimal(UInt16)Converts the value of the specified 16-bit unsigned integer to the equivalent Decimal number.
Public methodStatic memberToDecimal(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent Decimal number.
Public methodStatic memberToDecimal(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent Decimal number.
Public methodStatic memberToDecimal(Object, IFormatProvider)Converts the value of the specified Object to an Decimal number using the specified culture-specific formatting information.
Public methodStatic memberToDecimal(String, IFormatProvider)Converts the specified String representation of a number to an equivalent Decimal number using the specified culture-specific formatting information.
Public methodStatic memberToDouble(Boolean)Converts the value of the specified Boolean value to the equivalent double-precision floating point number.
Public methodStatic memberToDouble(Byte)Converts the value of the specified 8-bit unsigned integer to the equivalent double-precision floating point number.
Public methodStatic memberToDouble(Char)Calling this method always throws InvalidCastException.
Public methodStatic memberToDouble(Decimal)Converts the value of the specified Decimal number to an equivalent double-precision floating point number.
Public methodStatic memberToDouble(Double)Returns the specified double-precision floating point number; no actual conversion is performed.
Public methodStatic memberToDouble(Int16)Converts the value of the specified 16-bit signed integer to an equivalent double-precision floating point number.
Public methodStatic memberToDouble(Int32)Converts the value of the specified 32-bit signed integer to an equivalent double-precision floating point number.
Public methodStatic memberToDouble(Int64)Converts the value of the specified 64-bit signed integer to an equivalent double-precision floating point number.
Public methodStatic memberToDouble(Object)Converts the value of the specified Object to a double-precision floating point number.
Public methodStatic memberToDouble(SByte)Converts the value of the specified 8-bit signed integer to the equivalent double-precision floating point number.
Public methodStatic memberToDouble(Single)Converts the value of the specified single-precision floating point number to an equivalent double-precision floating point number.
Public methodStatic memberToDouble(String)Converts the specified String representation of a number to an equivalent double-precision floating point number.
Public methodStatic memberToDouble(UInt16)Converts the value of the specified 16-bit unsigned integer to the equivalent double-precision floating point number.
Public methodStatic memberToDouble(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent double-precision floating point number.
Public methodStatic memberToDouble(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent double-precision floating point number.
Public methodStatic memberToDouble(Object, IFormatProvider)Converts the value of the specified Object to an double-precision floating point number using the specified culture-specific formatting information.
Public methodStatic memberToDouble(String, IFormatProvider)Converts the specified String representation of a number to an equivalent double-precision floating point number using the specified culture-specific formatting information.
Public methodStatic memberToInt16(Boolean)Converts the value of the specified Boolean value to the equivalent 16-bit signed integer.
Public methodStatic memberToInt16(Byte)Converts the value of the specified 8-bit unsigned integer to the equivalent 16-bit signed integer.
Public methodStatic memberToInt16(Char)Converts the value of the specified Unicode character to the equivalent 16-bit signed integer.
Public methodStatic memberToInt16(Decimal)Converts the value of the specified Decimal number to an equivalent 16-bit signed integer.
Public methodStatic memberToInt16(Double)Converts the value of the specified double-precision floating point number to an equivalent 16-bit signed integer.
Public methodStatic memberToInt16(Int16)Returns the specified 16-bit signed integer; no actual conversion is performed.
Public methodStatic memberToInt16(Int32)Converts the value of the specified 32-bit signed integer to an equivalent 16-bit signed integer.
Public methodStatic memberToInt16(Int64)Converts the value of the specified 64-bit signed integer to an equivalent 16-bit signed integer.
Public methodStatic memberToInt16(Object)Converts the value of the specified Object to a 16-bit signed integer.
Public methodStatic memberToInt16(SByte)Converts the value of the specified 8-bit signed integer to the equivalent 16-bit signed integer.
Public methodStatic memberToInt16(Single)Converts the value of the specified single-precision floating point number to an equivalent 16-bit signed integer.
Public methodStatic memberToInt16(String)Converts the specified String representation of a number to an equivalent 16-bit signed integer.
Public methodStatic memberToInt16(UInt16)Converts the value of the specified 16-bit unsigned integer to the equivalent 16-bit signed integer.
Public methodStatic memberToInt16(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent 16-bit signed integer.
Public methodStatic memberToInt16(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent 16-bit signed integer.
Public methodStatic memberToInt16(Object, IFormatProvider)Converts the value of the specified Object to a 16-bit signed integer using the specified culture-specific formatting information.
Public methodStatic memberToInt16(String, IFormatProvider)Converts the specified String representation of a number to an equivalent 16-bit signed integer using specified culture-specific formatting information.
Public methodStatic memberToInt16(String, Int32)Converts the string representation of a number in a specified base to an equivalent 16-bit signed integer.
Public methodStatic memberToInt32(Boolean)Converts the value of the specified Boolean value to the equivalent 32-bit signed integer.
Public methodStatic memberToInt32(Byte)Converts the value of the specified 8-bit unsigned integer to the equivalent 32-bit signed integer.
Public methodStatic memberToInt32(Char)Converts the value of the specified Unicode character to the equivalent 32-bit signed integer.
Public methodStatic memberToInt32(Decimal)Converts the value of the specified Decimal number to an equivalent 32-bit signed integer.
Public methodStatic memberToInt32(Double)Converts the value of the specified double-precision floating point number to an equivalent 32-bit signed integer.
Public methodStatic memberToInt32(Int16)Converts the value of the specified 16-bit signed integer to an equivalent 32-bit signed integer.
Public methodStatic memberToInt32(Int32)Returns the specified 32-bit signed integer; no actual conversion is performed.
Public methodStatic memberToInt32(Int64)Converts the value of the specified 64-bit signed integer to an equivalent 32-bit signed integer.
Public methodStatic memberToInt32(Object)Converts the value of the specified Object to a 32-bit signed integer.
Public methodStatic memberToInt32(SByte)Converts the value of the specified 8-bit signed integer to the equivalent 32-bit signed integer.
Public methodStatic memberToInt32(Single)Converts the value of the specified single-precision floating point number to an equivalent 32-bit signed integer.
Public methodStatic memberToInt32(String)Converts the specified String representation of a number to an equivalent 32-bit signed integer.
Public methodStatic memberToInt32(UInt16)Converts the value of the specified 16-bit unsigned integer to the equivalent 32-bit signed integer.
Public methodStatic memberToInt32(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent 32-bit signed integer.
Public methodStatic memberToInt32(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent 32-bit signed integer.
Public methodStatic memberToInt32(Object, IFormatProvider)Converts the value of the specified Object to a 32-bit signed integer using the specified culture-specific formatting information.
Public methodStatic memberToInt32(String, IFormatProvider)Converts the specified String representation of a number to an equivalent 32-bit signed integer using specified culture-specific formatting information.
Public methodStatic memberToInt32(String, Int32)Converts the String representation of a number in a specified base to an equivalent 32-bit signed integer.
Public methodStatic memberToInt64(Boolean)Converts the value of the specified Boolean value to the equivalent 64-bit signed integer.
Public methodStatic memberToInt64(Byte)Converts the value of the specified 8-bit unsigned integer to the equivalent 64-bit signed integer.
Public methodStatic memberToInt64(Char)Converts the value of the specified Unicode character to the equivalent 64-bit signed integer.
Public methodStatic memberToInt64(Decimal)Converts the value of the specified Decimal number to an equivalent 64-bit signed integer.
Public methodStatic memberToInt64(Double)Converts the value of the specified double-precision floating point number to an equivalent 64-bit signed integer.
Public methodStatic memberToInt64(Int16)Converts the value of the specified 16-bit signed integer to an equivalent 64-bit signed integer.
Public methodStatic memberToInt64(Int32)Converts the value of the specified 32-bit signed integer to an equivalent 64-bit signed integer.
Public methodStatic memberToInt64(Int64)Returns the specified 64-bit signed integer; no actual conversion is performed.
Public methodStatic memberToInt64(Object)Converts the value of the specified Object to a 64-bit signed integer.
Public methodStatic memberToInt64(SByte)Converts the value of the specified 8-bit signed integer to the equivalent 64-bit signed integer.
Public methodStatic memberToInt64(Single)Converts the value of the specified single-precision floating point number to an equivalent 64-bit signed integer.
Public methodStatic memberToInt64(String)Converts the specified String representation of a number to an equivalent 64-bit signed integer.
Public methodStatic memberToInt64(UInt16)Converts the value of the specified 16-bit unsigned integer to the equivalent 64-bit signed integer.
Public methodStatic memberToInt64(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent 64-bit signed integer.
Public methodStatic memberToInt64(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent 64-bit signed integer.
Public methodStatic memberToInt64(Object, IFormatProvider)Converts the value of the specified Object to a 64-bit signed integer using the specified culture-specific formatting information.
Public methodStatic memberToInt64(String, IFormatProvider)Converts the specified String representation of a number to an equivalent 64-bit signed integer using the specified culture-specific formatting information.
Public methodStatic memberToInt64(String, Int32)Converts the string representation of a number in a specified base to an equivalent 64-bit signed integer.
Public methodStatic memberToSByte(Boolean)Converts the value of the specified Boolean value to the equivalent 8-bit signed integer.
Public methodStatic memberToSByte(Byte)Converts the value of the specified 8-bit unsigned integer to the equivalent 8-bit signed integer.
Public methodStatic memberToSByte(Char)Converts the value of the specified Unicode character to the equivalent 8-bit signed integer.
Public methodStatic memberToSByte(Decimal)Converts the value of the specified Decimal number to an equivalent 8-bit signed integer.
Public methodStatic memberToSByte(Double)Converts the value of the specified double-precision floating point number to an equivalent 8-bit signed integer.
Public methodStatic memberToSByte(Int16)Converts the value of the specified 16-bit signed integer to the equivalent 8-bit signed integer.
Public methodStatic memberToSByte(Int32)Converts the value of the specified 32-bit signed integer to an equivalent 8-bit signed integer.
Public methodStatic memberToSByte(Int64)Converts the value of the specified 64-bit signed integer to an equivalent 8-bit signed integer.
Public methodStatic memberToSByte(Object)Converts the value of the specified Object to an 8-bit signed integer.
Public methodStatic memberToSByte(SByte)Returns the specified 8-bit signed integer; no actual conversion is performed.
Public methodStatic memberToSByte(Single)Converts the value of the specified single-precision floating point number to an equivalent 8-bit signed integer.
Public methodStatic memberToSByte(String)Converts the specified String representation of a number to an equivalent 8-bit signed integer.
Public methodStatic memberToSByte(UInt16)Converts the value of the specified 16-bit unsigned integer to the equivalent 8-bit signed integer.
Public methodStatic memberToSByte(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent 8-bit signed integer.
Public methodStatic memberToSByte(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent 8-bit signed integer.
Public methodStatic memberToSByte(Object, IFormatProvider)Converts the value of the specified Object to an 8-bit signed integer using the specified culture-specific formatting information.
Public methodStatic memberToSByte(String, IFormatProvider)Converts the specified String representation of a number to an equivalent 8-bit signed integer using specified culture-specific formatting information.
Public methodStatic memberToSByte(String, Int32)Converts the string representation of a number in a specified base to an equivalent 8-bit signed integer.
Public methodStatic memberToSingle(Boolean)Converts the value of the specified Boolean value to the equivalent single-precision floating point number.
Public methodStatic memberToSingle(Byte)Converts the value of the specified 8-bit unsigned integer to the equivalent single-precision floating point number.
Public methodStatic memberToSingle(Char)Calling this method always throws InvalidCastException.
Public methodStatic memberToSingle(Decimal)Converts the value of the specified Decimal number to an equivalent single-precision floating point number.
Public methodStatic memberToSingle(Double)Converts the value of the specified double-precision floating point number to an equivalent single-precision floating point number.
Public methodStatic memberToSingle(Int16)Converts the value of the specified 16-bit signed integer to an equivalent single-precision floating point number.
Public methodStatic memberToSingle(Int32)Converts the value of the specified 32-bit signed integer to an equivalent single-precision floating point number.
Public methodStatic memberToSingle(Int64)Converts the value of the specified 64-bit signed integer to an equivalent single-precision floating point number.
Public methodStatic memberToSingle(Object)Converts the value of the specified Object to a single-precision floating point number.
Public methodStatic memberToSingle(SByte)Converts the value of the specified 8-bit signed integer to the equivalent single-precision floating point number.
Public methodStatic memberToSingle(Single)Returns the specified single-precision floating point number; no actual conversion is performed.
Public methodStatic memberToSingle(String)Converts the specified String representation of a number to an equivalent single-precision floating point number.
Public methodStatic memberToSingle(UInt16)Converts the value of the specified 16-bit unsigned integer to the equivalent single-precision floating point number.
Public methodStatic memberToSingle(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent single-precision floating point number.
Public methodStatic memberToSingle(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent single-precision floating point number.
Public methodStatic memberToSingle(Object, IFormatProvider)Converts the value of the specified Object to an single-precision floating point number using the specified culture-specific formatting information.
Public methodStatic memberToSingle(String, IFormatProvider)Converts the specified String representation of a number to an equivalent single-precision floating point number using the specified culture-specific formatting information.
Public methodStatic memberToString(Boolean)Converts the value of the specified Boolean to its equivalent String representation.
Public methodStatic memberToString(Byte)Converts the value of the specified 8-bit unsigned integer to its equivalent String representation.
Public methodStatic memberToString(Char)Converts the value of the specified Unicode character to its equivalent String representation.
Public methodStatic memberToString(DateTime)Converts the value of the specified DateTime to its equivalent String representation.
Public methodStatic memberToString(Decimal)Converts the value of the specified Decimal number to its equivalent String representation.
Public methodStatic memberToString(Double)Converts the value of the specified double-precision floating point number to its equivalent String representation.
Public methodStatic memberToString(Int16)Converts the value of the specified 16-bit signed integer to its equivalent String representation.
Public methodStatic memberToString(Int32)Converts the value of the specified 32-bit signed integer to its equivalent String representation.
Public methodStatic memberToString(Int64)Converts the value of the specified 64-bit signed integer to its equivalent String representation.
Public methodStatic memberToString(Object)Converts the value of the specified Object to its String representation.
Public methodStatic memberToString(SByte)Converts the value of the specified 8-bit signed integer to its equivalent String representation.
Public methodStatic memberToString(Single)Converts the value of the specified single-precision floating point number to its equivalent String representation.
Public methodStatic memberToString(UInt16)Converts the value of the specified 16-bit unsigned integer to its equivalent String representation.
Public methodStatic memberToString(UInt32)Converts the value of the specified 32-bit unsigned integer to its equivalent String representation.
Public methodStatic memberToString(UInt64)Converts the value of the specified 64-bit unsigned integer to its equivalent String representation.
Public methodStatic memberToString(Boolean, IFormatProvider)Converts the value of the specified Boolean to its equivalent String representation.
Public methodStatic memberToString(Byte, IFormatProvider)Converts the value of the specified 8-bit unsigned integer to its equivalent String representation.
Public methodStatic memberToString(Byte, Int32)Converts the value of an 8-bit unsigned integer to its equivalent string representation in a specified base.
Public methodStatic memberToString(Char, IFormatProvider)Converts the value of the specified Unicode character to its equivalent String representation.
Public methodStatic memberToString(DateTime, IFormatProvider)Converts the value of the specified DateTime to its equivalent String representation.
Public methodStatic memberToString(Decimal, IFormatProvider)Converts the value of the specified Decimal number to its equivalent String representation.
Public methodStatic memberToString(Double, IFormatProvider)Converts the value of the specified double-precision floating point number to its equivalent String representation.
Public methodStatic memberToString(Int16, IFormatProvider)Converts the value of the specified 16-bit signed integer to its equivalent String representation.
Public methodStatic memberToString(Int16, Int32)Converts the value of a 16-bit signed integer to its equivalent String representation in a specified base.
Public methodStatic memberToString(Int32, IFormatProvider)Converts the value of the specified 32-bit signed integer to its equivalent String representation.
Public methodStatic memberToString(Int32, Int32)Converts the value of a 32-bit signed integer to its equivalent String representation in a specified base.
Public methodStatic memberToString(Int64, IFormatProvider)Converts the value of the specified 64-bit signed integer to its equivalent String representation.
Public methodStatic memberToString(Int64, Int32)Converts the value of a 64-bit signed integer to its equivalent String representation in a specified base.
Public methodStatic memberToString(Object, IFormatProvider)Converts the value of the specified Object to its equivalent String representation using the specified culture-specific formatting information.
Public methodStatic memberToString(SByte, IFormatProvider)Converts the value of the specified 8-bit signed integer to its equivalent String representation.
Public methodStatic memberToString(Single, IFormatProvider)Converts the value of the specified single-precision floating point number to its equivalent String representation.
Public methodStatic memberToString(UInt16, IFormatProvider)Converts the value of the specified 16-bit unsigned integer to its equivalent String representation.
Public methodStatic memberToString(UInt32, IFormatProvider)Converts the value of the specified 32-bit unsigned integer to its equivalent String representation.
Public methodStatic memberToString(UInt64, IFormatProvider)Converts the value of the specified 64-bit unsigned integer to its equivalent String representation.
Public methodStatic memberToUInt16(Boolean)Converts the value of the specified Boolean value to the equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(Byte)Converts the value of the specified 8-bit unsigned integer to the equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(Char)Converts the value of the specified Unicode character to the equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(Decimal)Converts the value of the specified Decimal number to an equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(Double)Converts the value of the specified double-precision floating point number to an equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(Int16)Converts the value of the specified 16-bit signed integer to the equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(Int32)Converts the value of the specified 32-bit signed integer to an equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(Int64)Converts the value of the specified 64-bit signed integer to an equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(Object)Converts the value of the specified Object to a 16-bit unsigned integer.
Public methodStatic memberToUInt16(SByte)Converts the value of the specified 8-bit signed integer to the equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(Single)Converts the value of the specified single-precision floating point number to an equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(String)Converts the specified String representation of a number to an equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(UInt16)Returns the specified 16-bit unsigned integer; no actual conversion is performed.
Public methodStatic memberToUInt16(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt16(Object, IFormatProvider)Converts the value of the specified Object to a 16-bit unsigned integer using the specified culture-specific formatting information.
Public methodStatic memberToUInt16(String, IFormatProvider)Converts the specified String representation of a number to an equivalent 16-bit unsigned integer using specified culture-specific formatting information.
Public methodStatic memberToUInt16(String, Int32)Converts the string representation of a number in a specified base to an equivalent 16-bit unsigned integer.
Public methodStatic memberToUInt32(Boolean)Converts the value of the specified Boolean value to the equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(Byte)Converts the value of the specified 8-bit unsigned integer to the equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(Char)Converts the value of the specified Unicode character to the equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(Decimal)Converts the value of the specified Decimal number to an equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(Double)Converts the value of the specified double-precision floating point number to an equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(Int16)Converts the value of the specified 16-bit signed integer to the equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(Int32)Converts the value of the specified 32-bit signed integer to an equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(Int64)Converts the value of the specified 64-bit signed integer to an equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(Object)Converts the value of the specified Object to a 32-bit unsigned integer.
Public methodStatic memberToUInt32(SByte)Converts the value of the specified 8-bit signed integer to the equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(Single)Converts the value of the specified single-precision floating point number to an equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(String)Converts the specified String representation of a number to an equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(UInt16)Converts the value of the specified 16-bit unsigned integer to the equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(UInt32)Returns the specified 32-bit unsigned integer; no actual conversion is performed.
Public methodStatic memberToUInt32(UInt64)Converts the value of the specified 64-bit unsigned integer to an equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt32(Object, IFormatProvider)Converts the value of the specified Object to a 32-bit unsigned integer using the specified culture-specific formatting information.
Public methodStatic memberToUInt32(String, IFormatProvider)Converts the specified String representation of a number to an equivalent 32-bit unsigned integer using the specified culture-specific formatting information.
Public methodStatic memberToUInt32(String, Int32)Converts the string representation of a number in a specified base to an equivalent 32-bit unsigned integer.
Public methodStatic memberToUInt64(Boolean)Converts the value of the specified Boolean value to the equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(Byte)Converts the value of the specified 8-bit unsigned integer to the equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(Char)Converts the value of the specified Unicode character to the equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(Decimal)Converts the value of the specified Decimal number to an equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(Double)Converts the value of the specified double-precision floating point number to an equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(Int16)Converts the value of the specified 16-bit signed integer to the equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(Int32)Converts the value of the specified 32-bit signed integer to an equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(Int64)Converts the value of the specified 64-bit signed integer to an equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(Object)Converts the value of the specified Object to a 64-bit unsigned integer.
Public methodStatic memberToUInt64(SByte)Converts the value of the specified 8-bit signed integer to the equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(Single)Converts the value of the specified single-precision floating point number to an equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(String)Converts the specified String representation of a number to an equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(UInt16)Converts the value of the specified 16-bit unsigned integer to the equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(UInt32)Converts the value of the specified 32-bit unsigned integer to an equivalent 64-bit unsigned integer.
Public methodStatic memberToUInt64(UInt64)Returns the specified 64-bit unsigned integer; no actual conversion is performed.
Public methodStatic memberToUInt64(Object, IFormatProvider)Converts the value of the specified Object to a 64-bit unsigned integer using the specified culture-specific formatting information.
Public methodStatic memberToUInt64(String, IFormatProvider)Converts the specified String representation of a number to an equivalent 64-bit unsigned integer using the specified culture-specific formatting information.
Public methodStatic memberToUInt64(String, Int32)Converts the string representation of a number in a specified base to an equivalent 64-bit unsigned integer.
Top
  NameDescription
Public fieldStatic memberDBNullA constant representing a database column absent of data; that is, database null.
Top

The static methods of the Convert class are used to support conversion to and from the base data types in the .NET Framework. The supported base types are Boolean, Char, SByte, Byte, Int16, Int32, Int64, UInt16, UInt32, UInt64, Single, Double, Decimal, DateTime and String.

Conversions to and from Base Types

A conversion method exists to convert every base type to every other base type. However, the actual call to a particular conversion method can produce one of five outcomes, depending on the value of the base type at run time and the target base type. These five outcomes are:

  • No conversion. This occurs when an attempt is made to convert from a type to itself (for example, by calling Convert.ToInt32(Int32) with an argument of type Int32). In this case, the method simply returns an instance of the original type.

  • An InvalidCastException. This occurs when a particular conversion is not supported. An InvalidCastException is thrown for the following conversions:

  • A FormatException. This occurs when the attempt to convert a string value to any other base type fails because the string is not in the proper format. The exception is thrown for the following conversions:

    • A string to be converted to a Boolean value does not equal Boolean.TrueString or Boolean.FalseString.

    • A string to be converted to a Char value consists of multiple characters.

    • A string to be converted to any numeric type is not recognized as a valid number.

    • A string to be converted to a DateTime value is not recognized as a valid date and time value.

  • A successful conversion. For conversions between two different base types not listed in the previous outcomes, all widening conversions as well as all narrowing conversions that do not result in a loss of data will succeed and the method will return a value of the targeted base type.

  • An OverflowException. This occurs when a narrowing conversion results in a loss of data. For example, trying to convert a Int32 instance whose value is 10000 to a Byte type throws an OverflowException because 10000 is outside the range of the Byte data type.

An exception will not be thrown if the conversion of a numeric type results in a loss of precision (that is, the loss of some least significant digits). However, an exception will be thrown if the result is larger than can be represented by the particular conversion method's return value type.

For example, when a Double is converted to a Single, a loss of precision might occur but no exception is thrown. However, if the magnitude of the Double is too large to be represented by a Single, an overflow exception is thrown.

Conversions from Custom Objects to Base Types

In addition to supporting conversions between the base types, the Convert method supports conversion of any custom type to any base type. To do this, the custom type must implement the IConvertible interface, which defines methods for converting the implementing type to each of the base types. Conversions that are not supported by a particular type should throw an InvalidCastException.

When the ChangeType method is passed a custom type as its first parameter, or when the Convert.ToType method (such as Convert.ToInt32(Object) or Convert.ToDouble(Object, IFormatProvider) is called and passed an instance of a custom type as its first parameter, the Convert method, in turn, calls the custom type's IConvertible implementation to perform the conversion.

Culture-Specific Formatting Information

All the base type conversion methods and the ChangeType method include overloads that have a parameter of type IFormatProvider. For example, the Convert.ToBoolean method has the following two overloads:

The IFormatProvider parameter can supply culture-specific formatting information to assist the conversion process. However, it is ignored by most of the base type conversion methods. It is used only by the following base type conversion methods:

However, any user-defined type that implements IConvertible can make use of the IFormatProvider parameter.

Other Conversion Methods

A set of methods support converting an array of bytes to and from a String or array of Unicode characters consisting of base 64 digit characters. Data expressed as base 64 digits can be easily conveyed over data channels that can only transmit 7-bit characters.

The following code example demonstrates some of the conversion methods in the Convert class, including ToInt32, ToBoolean, and ToString. For information on how to compile and run this example code, see Building examples that have static TextBlock controls for Windows Phone 8.


double dNumber = 23.15;

try
{
   // Returns 23
   int iNumber = System.Convert.ToInt32(dNumber);
}
catch (System.OverflowException)
{
   outputBlock.Text +=
            "Overflow in double to int conversion." + "\n";
}
// 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)
{
   outputBlock.Text += "String is null" + "\n";
}
catch (System.FormatException)
{
   outputBlock.Text += "String length is greater than 1." + "\n";
}

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

outputBlock.Text += String.Format("Your integer as a double is {0}",
                   System.Convert.ToDouble(newInteger)) + "\n";


The following code example demonstrates several of the conversion methods in the Convert class. For information on how to compile and run this example code, see Building examples that have static TextBlock controls for Windows Phone 8.


// Sample for the Convert class summary.
using System;

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      string nl = "\n";
      string str = "{0}Return the Int64 equivalent of the following base types:{0}";
      bool xBool = false;
      short xShort = 1;
      int xInt = 2;
      long xLong = 3;
      float xSingle = 4.0f;
      double xDouble = 5.0;
      decimal xDecimal = 6.0m;
      string xString = "7";
      char xChar = '8'; // '8' = hexadecimal 38 = decimal 56
      byte xByte = 9;

      //  The following types are not CLS-compliant.
      ushort xUshort = 120;
      uint xUint = 121;
      ulong xUlong = 122;
      sbyte xSbyte = 123;

      //  The following type cannot be converted to an Int64.
      //  DateTime xDateTime = DateTime.Now;

      outputBlock.Text += String.Format(str, nl) + "\n";
      outputBlock.Text += String.Format("Boolean:  {0}", Convert.ToInt64(xBool)) + "\n";
      outputBlock.Text += String.Format("Int16:    {0}", Convert.ToInt64(xShort)) + "\n";
      outputBlock.Text += String.Format("Int32:    {0}", Convert.ToInt64(xInt)) + "\n";
      outputBlock.Text += String.Format("Int64:    {0}", Convert.ToInt64(xLong)) + "\n";
      outputBlock.Text += String.Format("Single:   {0}", Convert.ToInt64(xSingle)) + "\n";
      outputBlock.Text += String.Format("Double:   {0}", Convert.ToInt64(xDouble)) + "\n";
      outputBlock.Text += String.Format("Decimal:  {0}", Convert.ToInt64(xDecimal)) + "\n";
      outputBlock.Text += String.Format("String:   {0}", Convert.ToInt64(xString)) + "\n";
      outputBlock.Text += String.Format("Char:     {0}", Convert.ToInt64(xChar)) + "\n";
      outputBlock.Text += String.Format("Byte:     {0}", Convert.ToInt64(xByte)) + "\n";
      outputBlock.Text += "DateTime: There is no example of this conversion because" + "\n";
      outputBlock.Text += "          a DateTime cannot be converted to an Int64." + "\n";
      //
      outputBlock.Text += String.Format("{0}The following types are not CLS-compliant.{0}", nl) + "\n";
      outputBlock.Text += String.Format("UInt16:   {0}", Convert.ToInt64(xUshort)) + "\n";
      outputBlock.Text += String.Format("UInt32:   {0}", Convert.ToInt64(xUint)) + "\n";
      outputBlock.Text += String.Format("UInt64:   {0}", Convert.ToInt64(xUlong)) + "\n";
      outputBlock.Text += String.Format("SByte:    {0}", Convert.ToInt64(xSbyte)) + "\n";
   }
}
/*
This example produces the following results:

Return the Int64 equivalent of the following base types:

Boolean:  0
Int16:    1
Int32:    2
Int64:    3
Single:   4
Double:   5
Decimal:  6
String:   7
Char:     56
Byte:     9
DateTime: There is no example of this conversion because
          a DateTime cannot be converted to an Int64.

The following types are not CLS-compliant.

UInt16:   120
UInt32:   121
UInt64:   122
SByte:    123
*/


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.