Convert.ToBase64String Method (array<Byte[], Int32, Int32)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Converts a subset of an array of 8-bit unsigned integers to its equivalent String representation 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)

Syntax

'Declaration
Public Shared Function ToBase64String ( _
    inArray As Byte(), _
    offset As Integer, _
    length As Integer _
) As String
public static string ToBase64String(
    byte[] inArray,
    int offset,
    int length
)

Parameters

  • inArray
    Type: array<System.Byte[]
    An array of 8-bit unsigned integers.
  • 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.

Exceptions

Exception Condition
ArgumentNullException

inArray is nulla null reference (Nothing in Visual Basic).

ArgumentOutOfRangeException

offset or length is negative.

-or-

offset plus length is greater than the length of inArray.

Remarks

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.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.