Export (0) Print
Expand All

Buffer.ByteLength Method

Returns the number of bytes in the specified array.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public static int ByteLength (
	Array array
)
public static int ByteLength (
	Array array
)
public static function ByteLength (
	array : Array
) : int

Parameters

array

An array.

Return Value

The number of bytes in the array.

Exception typeCondition

ArgumentNullException

array is a null reference (Nothing in Visual Basic).

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
*/

// Example of the Buffer.ByteLength method.
import System.*;
import System.Console;

class ByteLengthDemo
{
    private static 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.
        Object objArr[] = new Object [] { name, arr.GetType().ToString(), 
            (Int32)arr.get_Length(), (Int32)byteLength };
        Console.WriteLine(formatter, objArr);
    } //ArrayInfo

    public static void main(String[] args)
    {
        ubyte bytes[] =  { 1, 2, 3, 4, 5, 6, 7, 8, 9, 0 };
        boolean bools[] =  { true, false, true, false, true };
        char chars[] =  { ' ', '$', '"', 'A', '{' };
        short shorts[] =  { 258, 259, 260, 261, 262, 263 };
        float singles[] =  { 1F, 678F, 2.37E+33F,0.00415F,8.9F };
        double doubles[] =  { 2E-22, 0.003, 4.4E+44, 5.55E+57 };
        long longs[] =  { 1, 10, 100, 1000, 10000, 100000 };
        Object objArr1[] = new Object[] { "Array name","Array type", "Length", 
            "ByteLength" };

        Console.WriteLine("This example of the Buffer.ByteLength( Array )\n"  
            + "method generates the following output.\n");
        Console.WriteLine(formatter, objArr1);

        Object objArr2[] = new Object[] { "----------", "----------", 
            "------", "----------" };
        Console.WriteLine(formatter, objArr2);

        // 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");
    } //main
} //ByteLengthDemo

/*
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 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft