This topic has not yet been rated - Rate this topic

Convert.ToByte Method (UInt64)

Converts the value of the specified 64-bit unsigned integer to an equivalent 8-bit unsigned integer.

This API is not CLS-compliant. 

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
[CLSCompliantAttribute(false)]
public static byte ToByte(
	ulong value
)

Parameters

value
Type: System.UInt64

The 64-bit unsigned integer to convert.

Return Value

Type: System.Byte
An 8-bit unsigned integer that is equivalent to value.
ExceptionCondition
OverflowException

value is greater than Byte.MaxValue.

The following example converts an array of unsigned long integers to Byte values.

ulong[] numbers= { UInt64.MinValue, 121, 340, UInt64.MaxValue };
byte result;
foreach (ulong number in numbers)
{
   try {
      result = Convert.ToByte(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", 
                        number.GetType().Name, number, 
                        result.GetType().Name, result);
   }                     
   catch (OverflowException)
   {
      Console.WriteLine("The {0} value {1} is outside the range of the Byte type.", 
                        number.GetType().Name, number);
   }
}
// The example displays the following output: 
//       Converted the UInt64 value 0 to the Byte value 0. 
//       Converted the UInt64 value 121 to the Byte value 121. 
//       The UInt64 value 340 is outside the range of the Byte type. 
//       The UInt64 value 18446744073709551615 is outside the range of the Byte type.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.