Export (0) Print
Expand All

Buffer.ByteLength Method

Returns the number of bytes in the specified array.

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

[SecuritySafeCriticalAttribute]
public static int ByteLength(
	Array array
)

Parameters

array
Type: System.Array
An array.

Return Value

Type: System.Int32
The number of bytes in the array.

ExceptionCondition
ArgumentNullException

array is null.

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 Example
{
   const string formatter = "{0,10}{1,20}{2,9}{3,12}";

   public static void ArrayInfo(System.Windows.Controls.TextBlock outputBlock, Array arr, string name)
   {
      int byteLength = Buffer.ByteLength(arr);

      // Display the array name, type, Length, and ByteLength.
      outputBlock.Text += String.Format(formatter, name, arr.GetType(),
          arr.Length, byteLength) + "\n";
   }

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      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 };

      outputBlock.Text += String.Format(
          "This example of the Buffer.ByteLength( Array ) " +
          "\nmethod generates the following output.\n") + "\n";
      outputBlock.Text += String.Format(formatter, "Array name", "Array type",
          "Length", "ByteLength") + "\n";
      outputBlock.Text += String.Format(formatter, "----------", "----------",
          "------", "----------") + "\n";

      // Display the Length and ByteLength for each array.
      ArrayInfo(outputBlock, bytes, "bytes");
      ArrayInfo(outputBlock, bools, "bools");
      ArrayInfo(outputBlock, chars, "chars");
      ArrayInfo(outputBlock, shorts, "shorts");
      ArrayInfo(outputBlock, singles, "singles");
      ArrayInfo(outputBlock, doubles, "doubles");
      ArrayInfo(outputBlock, 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
*/


Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

ADD
Show:
© 2014 Microsoft