Convert.ToBase64String Method (Byte[], Int32, Int32)
Converts a subset of an array of 8-bit unsigned integers to its equivalent string representation that is encoded with base-64 digits. Parameters specify the subset as an offset in the input array, and the number of elements in the array to convert.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Parameters
- inArray
- Type: System.Byte[]
An array of 8-bit unsigned integers.
- offset
- Type: System.Int32
An offset in inArray.
- length
- Type: System.Int32
The number of elements of inArray to convert.
Return Value
Type: System.StringThe string representation in base 64 of length elements of inArray, starting at position offset.
| Exception | Condition |
|---|---|
| ArgumentNullException | inArray is null. |
| ArgumentOutOfRangeException | offset or length is negative. -or- offset plus length is greater than the length of inArray. |
The elements of inArray are taken as a numeric value and converted to a string representation in base 64.
The base-64 digits in ascending order from zero are the uppercase characters "A" to "Z", the lowercase characters "a" to "z", the numerals "0" to "9", and the symbols "+" and "/". The valueless character, "=", is used for trailing padding.
The offset and length parameters are 32-bit signed numbers. The offset parameter is zero-based.
 Important |
|---|
The ToBase64String method is designed to process a single byte array that contains all the data to be encoded. To encode data from a stream, use the System.Security.Cryptography.ToBase64Transform class. |
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
