Class BitConverter

Converts base data types to an array of bytes, and an array of bytes to base data types.

Inheritance

Object

BitConverter

Inherited Members

Object.ToString()

Object.Equals(Object)

Object.Equals(Object, Object)

Object.ReferenceEquals(Object, Object)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Namespace: System

Assembly: mscorlib.dll

Syntax

public static class BitConverter

Properties

IsLittleEndian

Indicates the byte order ("endianess") in which data is stored in this computer architecture.

Declaration

public static bool IsLittleEndian { get; }

Property Value

Type	Description
Boolean

Methods

DoubleToInt64Bits(Double)

Converts the specified double-precision floating point number to a 64-bit signed integer.

Declaration

public static extern long DoubleToInt64Bits(double value)

Parameters

Type	Name	Description
Double	value	The number to convert.

Returns

Type	Description
Int64

GetBytes(Boolean)

Returns the specified Boolean value as an array of bytes.

Declaration

public static extern byte[] GetBytes(bool value)

Parameters

Type	Name	Description
Boolean	value	A Boolean value.

Returns

Type	Description
Byte[]	An array of bytes with length 1.

GetBytes(Char)

Returns the specified Unicode character value as an array of bytes.

Declaration

public static extern byte[] GetBytes(char value)

Parameters

Type	Name	Description
Char	value	A character to convert.

Returns

Type	Description
Byte[]	An array of bytes with length 2.

GetBytes(Double)

Returns the specified double-precision floating point value as an array of bytes.

Declaration

public static extern byte[] GetBytes(double value)

Parameters

Type	Name	Description
Double	value	The number to convert.

Returns

Type	Description
Byte[]	An array of bytes with length 8.

GetBytes(Int16)

Returns the specified 16-bit signed integer value as an array of bytes.

Declaration

public static extern byte[] GetBytes(short value)

Parameters

Type	Name	Description
Int16	value	The number to convert.

Returns

Type	Description
Byte[]	An array of bytes with length 2.

GetBytes(Int32)

Returns the specified 32-bit signed integer value as an array of bytes.

Declaration

public static extern byte[] GetBytes(int value)

Parameters

Type	Name	Description
Int32	value	The number to convert.

Returns

Type	Description
Byte[]	An array of bytes with length 4.

GetBytes(Int64)

Returns the specified 64-bit signed integer value as an array of bytes.

Declaration

public static extern byte[] GetBytes(long value)

Parameters

Type	Name	Description
Int64	value	The number to convert.

Returns

Type	Description
Byte[]	An array of bytes with length 8.

GetBytes(Single)

Returns the specified single-precision floating point value as an array of bytes.

Declaration

public static extern byte[] GetBytes(float value)

Parameters

Type	Name	Description
Single	value	The number to convert.

Returns

Type	Description
Byte[]	An array of bytes with length 4.

GetBytes(UInt16)

Returns the specified 16-bit unsigned integer value as an array of bytes.

Declaration

public static extern byte[] GetBytes(ushort value)

Parameters

Type	Name	Description
UInt16	value	The number to convert.

Returns

Type	Description
Byte[]	An array of bytes with length 2.

GetBytes(UInt32)

Returns the specified 32-bit unsigned integer value as an array of bytes.

Declaration

public static extern byte[] GetBytes(uint value)

Parameters

Type	Name	Description
UInt32	value	The number to convert.

Returns

Type	Description
Byte[]	An array of bytes with length 4.

GetBytes(UInt64)

Returns the specified 64-bit unsigned integer value as an array of bytes.

Declaration

public static extern byte[] GetBytes(ulong value)

Parameters

Type	Name	Description
UInt64	value	The number to convert.

Returns

Type	Description
Byte[]	An array of bytes with length 8.

Int64BitsToDouble(Int64)

Converts the specified 64-bit signed integer to a double-precision floating point number.

Declaration

public static extern double Int64BitsToDouble(long value)

Parameters

Type	Name	Description
Int64	value	The number to convert.

Returns

Type	Description
Double	A double-precision floating point number whose value is equivalent to value.

ToBoolean(Byte[], Int32)

Returns a Boolean value converted from one byte at a specified position in a byte array.

Declaration

public static extern bool ToBoolean(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
Boolean	true if the byte at startIndex in value is nonzero; otherwise, false.

ToChar(Byte[], Int32)

Returns a Unicode character converted from two bytes at a specified position in a byte array.

Declaration

public static extern char ToChar(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
Char	A character formed by two bytes beginning at startIndex.

ToDouble(Byte[], Int32)

Returns a double-precision floating point number converted from eight bytes at a specified position in a byte array.

Declaration

public static extern double ToDouble(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
Double	A double precision floating point number formed by eight bytes beginning at startIndex.

ToInt16(Byte[], Int32)

Returns a 16-bit signed integer converted from two bytes at a specified position in a byte array.

Declaration

public static extern short ToInt16(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
Int16	A 16-bit signed integer formed by two bytes beginning at startIndex.

ToInt32(Byte[], Int32)

Returns a 32-bit signed integer converted from four bytes at a specified position in a byte array.

Declaration

public static extern int ToInt32(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
Int32	A 32-bit signed integer formed by four bytes beginning at startIndex.

ToInt64(Byte[], Int32)

Returns a 64-bit signed integer converted from eight bytes at a specified position in a byte array.

Declaration

public static extern long ToInt64(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
Int64	A 64-bit signed integer formed by eight bytes beginning at startIndex.

ToSingle(Byte[], Int32)

Returns a single-precision floating point number converted from four bytes at a specified position in a byte array.

Declaration

public static extern float ToSingle(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
Single	A single-precision floating point number formed by four bytes beginning at startIndex.

ToString(Byte[])

Converts the numeric value of each element of a specified array of bytes to its equivalent hexadecimal string representation.

Declaration

public static extern string ToString(byte[] value)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.

Returns

Type	Description
String	A String of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in value; for example, "7F-2C-4A".

ToString(Byte[], Int32)

Converts the numeric value of each element of a specified subarray of bytes to its equivalent hexadecimal string representation.

Declaration

public static extern string ToString(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
String	A String of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in a subarray of value; for example, "7F-2C-4A".

ToString(Byte[], Int32, Int32)

Converts the numeric value of each element of a specified subarray of bytes to its equivalent hexadecimal string representation.

Declaration

public static extern string ToString(byte[] value, int startIndex, int length)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.
Int32	startIndex	The starting position within value.
Int32	length	The number of array elements in value to convert.

Returns

Type	Description
String	A String of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in a subarray of value; for example, "7F-2C-4A".

ToUInt16(Byte[], Int32)

Returns a 16-bit unsigned integer converted from two bytes at a specified position in a byte array.

Declaration

[CLSCompliant(false)]
public static extern ushort ToUInt16(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	An array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
UInt16	A 16-bit unsigned integer formed by two bytes beginning at startIndex.

ToUInt32(Byte[], Int32)

Returns a 32-bit unsigned integer converted from two bytes at a specified position in a byte array.

Declaration

[CLSCompliant(false)]
public static extern uint ToUInt32(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	The array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
UInt32	A 32-bit unsigned integer formed by two bytes beginning at startIndex.

ToUInt64(Byte[], Int32)

Returns a 64-bit unsigned integer converted from two bytes at a specified position in a byte array.

Declaration

[CLSCompliant(false)]
public static extern ulong ToUInt64(byte[] value, int startIndex)

Parameters

Type	Name	Description
Byte[]	value	The array of bytes.
Int32	startIndex	The starting position within value.

Returns

Type	Description
UInt64	A 64-bit unsigned integer formed by two bytes beginning at startIndex.