Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
ToBase64String Method (Byte[], Int32, Int32)

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
Assemblies:   System.Runtime.Extensions (in System.Runtime.Extensions.dll)
  mscorlib (in mscorlib.dll)

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

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.String
The string representation in base 64 of length elements of inArray, starting at position offset.

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

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.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Portable Class Library

Supported in: Portable Class Library
Show:
© 2015 Microsoft