Convert.ToBase64CharArray Method

May 11, 2014

Converts a subset of an 8-bit unsigned integer array to an equivalent subset of a Unicode character array encoded with base 64 digits. Parameters specify the subsets as offsets in the input and output arrays, and the number of elements in the input array to convert.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public static int ToBase64CharArray(
	byte[] inArray,
	int offsetIn,
	int length,
	char[] outArray,
	int offsetOut
)

Parameters

inArray
Type: System.Byte []
An input array of 8-bit unsigned integers.
offsetIn
Type: System.Int32
A position within inArray.
length
Type: System.Int32
The number of elements of inArray to convert.
outArray
Type: System.Char []
An output array of Unicode characters.
offsetOut
Type: System.Int32
A position within outArray.

Return Value

Type: System.Int32
A 32-bit signed integer containing the number of bytes in outArray.

ExceptionCondition
ArgumentNullException

inArray or outArray is null.

ArgumentOutOfRangeException

offsetIn, offsetOut, or length is negative.

-or-

offsetIn plus length is greater than the length of inArray.

-or-

offsetOut plus the number of elements to return is greater than the length of outArray.

The subset of length elements of inArray starting at position offsetIn, are taken as a numeric value and converted to a subset of elements in outArray starting at position offsetOut. The return value indicates the number of converted elements in outArray. The subset of outArray consists of base 64 digits.

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 offsetIn and offsetOut parameters are zero-based array positions.

The following example demonstrates using the ToBase64CharArray method to convert a string to a UUEncoded character array and then convert it back to the original string.


byte[] bytes;
string originalString = "The contents of the original string form a sentence.";
outputBlock.Text += String.Format("The original string:\n   {0}\n", 
                                  originalString);

// Convert the string to a byte array.
UnicodeEncoding encoder = new UnicodeEncoding();
bytes = encoder.GetBytes(originalString);

// Convert the byte array to a base 64 encoded Char array.
char[] encodedChars = new char[1023]; 
int nChars;                        // Length of character array.
nChars = Convert.ToBase64CharArray(bytes, 0, bytes.Length, 
                                   encodedChars, 0);
// Display the encoded characters.
string encodedString = new string(encodedChars); 
outputBlock.Text += String.Format("The UUEncoded string:\n   {0}\n", 
                                  encodedString.Substring(0, nChars)); 

// Convert UUEncoded Char array to a byte array.
bytes = Convert.FromBase64CharArray(encodedChars, 0, nChars);

// Convert byte array back to the original string.
originalString = encoder.GetString(bytes, 0, bytes.Length); 
outputBlock.Text += String.Format("The original string restored:\n   {0}\n",
                                  originalString);
// The example displays the following output;
//       The original string:
//          The contents of the original string form a sentence.
//       The UUEncoded string:
//          VABoAGUAIABjAG8AbgB0AGUAbgB0AHMAIABvAGYAIAB0AGgAZQAgAG8AcgBpAGcAaQBuAGEAbAAgA
//       HMAdAByAGkAbgBnACAAZgBvAHIAbQAgAGEAIABzAGUAbgB0AGUAbgBjAGUALgA=
//       
//       The original string restored:
//          The contents of the original string form a sentence.


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft