BitConverter.ToUInt32 Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Returns a 32-bit unsigned integer converted from four bytes at a specified position in a byte array.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
- Type:
System.Byte
[]
An array of bytes.
- startIndex
- Type: System.Int32
The starting position within value.
Return Value
Type: System.UInt32A 32-bit unsigned integer formed by four bytes beginning at startIndex.
| Exception | Condition |
|---|---|
| ArgumentException | startIndex is greater than or equal to the length of value minus 3, and is less than or equal to the length of value minus 1. |
| ArgumentNullException | value is null. |
| ArgumentOutOfRangeException | startIndex is less than zero or greater than the length of value minus 1. |
The following code example converts elements of Byte arrays to UInt32 values with the ToUInt32 method.
// Example of the BitConverter.ToUInt32 method. using System; class Example { const string formatter = "{0,5}{1,17}{2,15}"; // Convert four byte array elements to a uint and display it. public static void BAToUInt32(System.Windows.Controls.TextBlock outputBlock, byte[] bytes, int index) { uint value = BitConverter.ToUInt32(bytes, index); outputBlock.Text += String.Format(formatter, index, BitConverter.ToString(bytes, index, 4), value) + "\n"; } public static void Demo(System.Windows.Controls.TextBlock outputBlock) { byte[] byteArray = { 15, 0, 0, 0, 0, 16, 0, 255, 3, 0, 0, 202, 154, 59, 255, 255, 255, 255, 127 }; outputBlock.Text += String.Format( "This example of the BitConverter.ToUInt32( byte[ ], " + "int ) \nmethod generates the following output. It " + "converts elements \nof a byte array to uint values.\n") + "\n"; outputBlock.Text += "initial byte array" + "\n"; outputBlock.Text += "------------------" + "\n"; outputBlock.Text += BitConverter.ToString(byteArray) + "\n"; outputBlock.Text += "\n"; outputBlock.Text += String.Format(formatter, "index", "array elements", "uint") + "\n"; outputBlock.Text += String.Format(formatter, "-----", "--------------", "----") + "\n"; // Convert byte array elements to uint values. BAToUInt32(outputBlock, byteArray, 1); BAToUInt32(outputBlock, byteArray, 0); BAToUInt32(outputBlock, byteArray, 7); BAToUInt32(outputBlock, byteArray, 3); BAToUInt32(outputBlock, byteArray, 10); BAToUInt32(outputBlock, byteArray, 15); BAToUInt32(outputBlock, byteArray, 14); } } /* This example of the BitConverter.ToUInt32( byte[ ], int ) method generates the following output. It converts elements of a byte array to uint values. initial byte array ------------------ 0F-00-00-00-00-10-00-FF-03-00-00-CA-9A-3B-FF-FF-FF-FF-7F index array elements uint ----- -------------- ---- 1 00-00-00-00 0 0 0F-00-00-00 15 7 FF-03-00-00 1023 3 00-00-10-00 1048576 10 00-CA-9A-3B 1000000000 15 FF-FF-FF-7F 2147483647 14 FF-FF-FF-FF 4294967295 */