Buffer.ByteLength Method
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Returns the number of bytes in the specified array.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Parameters
- array
- Type: System.Array
An array.
| Exception | Condition |
|---|---|
| ArgumentNullException |
array is null. |
| ArgumentException |
array is not a primitive. |
| OverflowException |
array is larger than 2 gigabytes (GB). |
The following code example illustrates the use of the ByteLength method to return the number of bytes in an array.
// Example of the Buffer.ByteLength method. using System; class ByteLengthDemo { const string formatter = "{0,10}{1,20}{2,9}{3,12}"; public static void ArrayInfo( Array arr, string name ) { int byteLength = Buffer.ByteLength( arr ); // Display the array name, type, Length, and ByteLength. Console.WriteLine( formatter, name, arr.GetType( ), arr.Length, byteLength ); } public static void Main( ) { byte[ ] bytes = { 1, 2, 3, 4, 5, 6, 7, 8, 9, 0 }; bool[ ] bools = { true, false, true, false, true }; char[ ] chars = { ' ', '$', '\"', 'A', '{' }; short[ ] shorts = { 258, 259, 260, 261, 262, 263 }; float[ ] singles = { 1, 678, 2.37E33F, .00415F, 8.9F }; double[ ] doubles = { 2E-22, .003, 4.4E44, 555E55 }; long[ ] longs = { 1, 10, 100, 1000, 10000, 100000 }; Console.WriteLine( "This example of the Buffer.ByteLength( Array ) " + "\nmethod generates the following output.\n" ); Console.WriteLine( formatter, "Array name", "Array type", "Length", "ByteLength" ); Console.WriteLine( formatter, "----------", "----------", "------", "----------" ); // Display the Length and ByteLength for each array. ArrayInfo( bytes, "bytes" ); ArrayInfo( bools, "bools" ); ArrayInfo( chars, "chars" ); ArrayInfo( shorts, "shorts" ); ArrayInfo( singles, "singles" ); ArrayInfo( doubles, "doubles" ); ArrayInfo( longs, "longs" ); } } /* This example of the Buffer.ByteLength( Array ) method generates the following output. Array name Array type Length ByteLength ---------- ---------- ------ ---------- bytes System.Byte[] 10 10 bools System.Boolean[] 5 5 chars System.Char[] 5 10 shorts System.Int16[] 6 12 singles System.Single[] 5 20 doubles System.Double[] 4 32 longs System.Int64[] 6 48 */
Windows 8 Consumer Preview, Windows Server 8 Beta, Windows 7, Windows Server 2008 SP2, 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.