Buffer.ByteLength Method
.NET Framework 4
Returns the number of bytes in the specified array.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- array
- Type: System.Array
An array.
| Exception | Condition |
|---|---|
| ArgumentNullException |
array is Nothing. |
| ArgumentException |
array is not a primitive. |
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 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
