System.Buffer.ByteLength 方法
方法描述
返回指定数组中的字节数。
语法定义(C# System.Buffer.ByteLength 方法 的用法)
public static int ByteLength( Array array )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| array | System-Array | 一个数组。 |
| 返回值 | System.Int32 | 数组中的字节数。 |
提示和注释
System.Buffer.ByteLength 方法例子
下面的代码示例演示如何使用 ByteLength 方法返回数组中的字节数。
// 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
*/
异常
| 异常 | 异常描述 |
|---|---|
| ArgumentNullException | array 为 null。 |
| ArgumentException | array 不是基元。 |
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。