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.
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. 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
Show: