ByteLength Method
Collapse the table of content
Expand the table of content

Buffer.ByteLength Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Returns the number of bytes in the specified array.

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

'Declaration
Public Shared Function ByteLength ( _
	array As Array _
) As Integer

Parameters

array
Type: System.Array
An array.

Return Value

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

ExceptionCondition
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.

Module Example

   Const formatter As String = "{0,10}{1,20}{2,9}{3,12}"

   Sub ArrayInfo(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal arr As Array, ByVal name As String)

      Dim byteLength As Integer = Buffer.ByteLength(arr)

      ' Display the array name, type, Length, and ByteLength.
      outputBlock.Text &= String.Format(formatter, name, arr.GetType, arr.Length, _
          byteLength) & vbCrLf
   End Sub

   Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
      Dim bytes() As Byte = {1, 2, 3, 4, 5, 6, 7, 8, 9, 0}
      Dim bools() As Boolean = {True, False, True, False, True}
      Dim chars() As Char = {" "c, "$"c, """"c, "A"c, "{"c}
      Dim shorts() As Short = {258, 259, 260, 261, 262, 263}
      Dim singles() As Single = {1, 678, 2.37E+33, 0.00415, 8.9}
      Dim doubles() As Double = {2.0E-22, 0.003, 4.4E+44, 5.55E+57}
      Dim longs() As Long = {1, 10, 100, 1000, 10000, 100000}

      outputBlock.Text &= String.Format( _
          "This example of the Buffer.ByteLength( Array ) " & _
          vbCrLf & "method generates the following output." & vbCrLf) & vbCrLf
      outputBlock.Text &= String.Format(formatter, "Array name", "Array type", _
          "Length", "ByteLength") & vbCrLf
      outputBlock.Text &= String.Format(formatter, "----------", "----------", _
          "------", "----------") & vbCrLf

      ' 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")
   End Sub
End Module

' 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 Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2017 Microsoft