System.Convert.ToBase64String 方法 (Byte[], Int32, Int32)

方法描述

将 8 位无符号整数数组的子集转换为其用 Base64 数字编码的等效字符串表示形式。 参数将子集指定为输入数组中的偏移量和数组中要转换的元素数。

语法定义(C# System.Convert.ToBase64String 方法 (Byte[], Int32, Int32) 的用法)

public static string ToBase64String(
	byte[] inArray,
	int offset,
	int length
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
inArray System-Byte[] 一个 8 位无符号整数数组。
offset System-Int32 inArray 中的偏移量。
length System-Int32 要转换的 inArray 的元素数。
返回值 System.String inArray 中从位置 offset 开始的 length 个元素的字符串表示形式,以 Base64 表示。

提示和注释

inArray 的元素作为一个数字值,并且转换为字符串表示形式(以基数为 64 的数字表示)。

从零开始升序排列的 Base 64 数字分别为大写字符“A”到“Z”、小写字符“a”到“z”、数字“0”到“9”以及符号“+”和“/”。 无值字符“=”用于尾部的空白。

offset 和 length 参数是 32 位有符号数字。 offset 参数从零开始。

重要事项

该 ToBase64String 方法旨在处理包含要编码的所有数据的单字节数组。 要从流对数据进行编码,请使用 System.Security.Cryptography.ToBase64Transform 类。

System.Convert.ToBase64String 方法 (Byte[], Int32, Int32)例子


异常

异常 异常描述
ArgumentNullException inArray 为 null。
ArgumentOutOfRangeException
  • offset 或 length 为负。
  • offset 加上 length 大于 inArray 的长度。

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.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 系统要求。