Convert.ToBase64String メソッド (Byte[])

8 ビット符号なし整数配列の値を、base 64 の数字で構成される等価の String 形式に変換します。

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

パラメータ

• inArray
  8 ビット符号なし整数の配列。

戻り値

base 64 の数字で構成される String 形式での inArray の内容。

例外

例外の種類	条件
ArgumentNullException	inArray が null 参照 (Visual Basic では Nothing) です。

解説

inArray の要素は数値として解釈され、base 64 の数字で構成される String 形式へ変換されます。

Base64 形式の文字を 0 から昇順で並べると、大文字の 'A' ～ 'Z'、小文字の 'a' ～ 'z'、数字の '0' ～ '9'、および '+' と '/' の記号になります。値として解釈されない文字 '=' は、文字列末尾の埋め込み用に使用されます。

使用例

[Visual Basic, C#, C++] ToBase64String メソッドを使用して、バイナリ ストリームの UU エンコード (base 64 エンコード) を行い、ファイルに保存する方法を次の例に示します。

 
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] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Convert クラス | Convert メンバ | System 名前空間 | Convert.ToBase64String オーバーロードの一覧 | Byte