Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

Convert.ToBase64String Method (Byte[])

.NET Framework 1.1

Converts the value of an array of 8-bit unsigned integers to its equivalent String representation consisting of base 64 digits.

[Visual Basic]
Overloads Public Shared Function ToBase64String( _
   ByVal inArray() As Byte _
) As String
[C#]
public static string ToBase64String(
 byte[] inArray
);
[C++]
public: static String* ToBase64String(
 unsigned char inArray __gc[]
);
[JScript]
public static function ToBase64String(
   inArray : Byte[]
) : String;

Parameters

inArray
An array of 8-bit unsigned integers.

Return Value

The String representation, in base 64, of the contents of inArray.

Exceptions

Exception Type Condition
ArgumentNullException inArray is a null reference (Nothing in Visual Basic).

Remarks

The elements of inArray are taken as a numeric value and converted to a String representation consisting of base 64 digits.

The base 64 digits in ascending order from zero are the uppercase characters 'A' to 'Z', lowercase characters 'a' to 'z', numerals '0' to '9', and the symbols '+' and '/'. The valueless character, '=', is used for trailing padding.

Example

[Visual Basic, C#, C++] The following sample demonstrates the ToBase64String method, UUencoding (base 64 encoding) a binary stream and saving it to a file.

[Visual Basic] 
Public Sub EncodeWithString()
   Dim inFile As System.IO.FileStream
   Dim binaryData() As Byte

   Try
      inFile = New System.IO.FileStream(inputFileName, _
                                        System.IO.FileMode.Open, _
                                        System.IO.FileAccess.Read)
      ReDim binaryData(inFile.Length)
      Dim bytesRead As Long = inFile.Read(binaryData, _
                                          0, _
                                          inFile.Length)
      inFile.Close()
   Catch exp As System.Exception
      ' Error creating stream or reading from it.
      System.Console.WriteLine("{0}", exp.Message)
      Return
   End Try

   ' Convert the binary input into Base64 UUEncoded output.
   Dim base64String As String
   Try
      base64String = System.Convert.ToBase64String(binaryData, _
                                                   0, _
                                                   binaryData.Length)
   Catch exp As System.ArgumentNullException
      System.Console.WriteLine("Binary data array is null.")
      Return
   End Try

   ' Write the UUEncoded version to the output file.
   Dim outFile As System.IO.StreamWriter
   Try
      outFile = New System.IO.StreamWriter(outputFileName, _
                                           False, _
                                           System.Text.Encoding.ASCII)
      outFile.Write(base64String)
      outFile.Close()
   Catch exp As System.Exception
      ' Error creating stream or writing to it.
      System.Console.WriteLine("{0}", exp.Message)
   End Try
End Sub

[C#] 
public void EncodeWithString() {
    System.IO.FileStream inFile;     
    byte[]                 binaryData;

    try {
        inFile = new System.IO.FileStream(inputFileName,
                                          System.IO.FileMode.Open,
                                          System.IO.FileAccess.Read);
        binaryData = new Byte[inFile.Length];
        long bytesRead = inFile.Read(binaryData, 0,
                                    (int)inFile.Length);
        inFile.Close();
    }
    catch (System.Exception exp) {
        // Error creating stream or reading from it.
        System.Console.WriteLine("{0}", exp.Message);
        return;
    }

    // Convert the binary input into Base64 UUEncoded output.
    string base64String;
    try {
         base64String = 
            System.Convert.ToBase64String(binaryData, 
                                          0,
                                          binaryData.Length);
    }
    catch (System.ArgumentNullException) {
        System.Console.WriteLine("Binary data array is null.");
        return;
    }

    // Write the UUEncoded version to the output file.
    System.IO.StreamWriter outFile; 
    try {
        outFile = new System.IO.StreamWriter(outputFileName,
                                    false,
                                    System.Text.Encoding.ASCII);             
        outFile.Write(base64String);
        outFile.Close();
    }
    catch (System.Exception exp) {
        // Error creating stream or writing to it.
        System.Console.WriteLine("{0}", exp.Message);
    }
}

[C++] 
public:
   void EncodeWithString() {
      FileStream* inFile;     
      Byte binaryData[];

      try {
         inFile = new FileStream(inputFileName,
            FileMode::Open,
            FileAccess::Read);
         binaryData = new Byte[(int)(inFile->Length)];
         long bytesRead = inFile->Read(binaryData, 0,
            (int)inFile->Length);
         inFile->Close();
      } catch (Exception* exp) {
         // Error creating stream or reading from it.
         Console::WriteLine(S" {0}", exp->Message);
         return;
      }

      // Convert the binary input into Base64 UUEncoded output.
      String* base64String;
      try {
         base64String = 
            Convert::ToBase64String(binaryData, 
            0,
            binaryData->Length);
      } catch (ArgumentNullException*) {
         Console::WriteLine(S"Binary data array is null.");
         return;
      }

      // Write the UUEncoded version to the output file.
      StreamWriter* outFile; 
      try {
         outFile = new StreamWriter(outputFileName,
            false,
            Text::Encoding::ASCII);             
         outFile->Write(base64String);
         outFile->Close();
      } catch (Exception* exp) {
         // Error creating stream or writing to it.
         Console::WriteLine(S" {0}", exp->Message);
      }
   }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Convert Class | Convert Members | System Namespace | Convert.ToBase64String Overload List | Byte

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.