Base64FormattingOptions 列挙体
メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。 関連する System.Convert.ToBase64CharArray メソッドと System.Convert.ToBase64String メソッドで、それぞれの出力に改行を挿入するかどうかを指定します。
アセンブリ: mscorlib (mscorlib.dll 内)
構文
メンバ
解説
使用例
プラットフォーム
バージョン情報
参照
この列挙体には、メンバ値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。
名前空間: Systemアセンブリ: mscorlib (mscorlib.dll 内)
構文<FlagsAttribute> _ Public Enumeration Base64FormattingOptions
メンバ解説ToBase64CharArray メソッドと ToBase64String メソッドは、8 ビット符号なし整数配列の値を、base 64 の数字で構成される等価の文字列形式に変換します。この文字列形式には、1 つ以上の改行を含めることができます。この改行は、復帰文字 (U+000D) とその後に続くライン フィード文字 (U+000A) として定義されます。
使用例Base64FormattingOptions 列挙体を使用して、System.Convert.ToBase64String メソッドの出力を個別の行に改行するコード例を次に示します。
' This example demonstrates the Convert.ToBase64String() and ' Convert.FromBase64String() methods Imports System Class Sample Public Shared Sub Main() Dim inArray(255) As Byte Dim outArray(255) As Byte Dim s2 As String Dim s3 As String Dim step1 As String = "1) The input is a byte array (inArray) of arbitrary data." Dim step2 As String = "2) Convert a subarray of the input data array to a base 64 string." Dim step3 As String = "3) Convert the entire input data array to a base 64 string." Dim step4 As String = "4) The two methods in steps 2 and 3 produce the same result?: {0}" Dim step5 As String = "5) Convert the base 64 string to an output byte array (outArray)." Dim step6 As String = "6) The input and output arrays, inArray and outArray, are equal?: {0}" Dim x As Integer Dim nl As String = Environment.NewLine Dim ruler1a As String = " 1 2 3 4" Dim ruler2a As String = "1234567890123456789012345678901234567890" Dim ruler3a As String = "----+----+----+----+----+----+----+----+" Dim ruler1b As String = " 5 6 7 " Dim ruler2b As String = "123456789012345678901234567890123456" Dim ruler3b As String = "----+----+----+----+----+----+----+-" Dim ruler As String = [String].Concat(ruler1a, ruler1b, nl, ruler2a, ruler2b, nl, ruler3a, ruler3b, nl) ' 1) Display an arbitrary array of input data (inArray). The data could be ' derived from user input, a file, an algorithm, etc. Console.WriteLine(step1) Console.WriteLine() For x = 0 To inArray.Length - 1 inArray(x) = CByte(x) Console.Write("{0:X2} ", inArray(x)) If (x + 1) Mod 20 = 0 Then Console.WriteLine() End If Next x Console.Write("{0}{0}", nl) ' 2) Convert a subarray of the input data to a base64 string. In this case, ' the subarray is the entire input data array. New lines (CRLF) are inserted. Console.WriteLine(step2) s2 = Convert.ToBase64String(inArray, 0, inArray.Length, _ Base64FormattingOptions.InsertLineBreaks) Console.WriteLine("{0}{1}{2}{3}", nl, ruler, s2, nl) ' 3) Convert the input data to a base64 string. In this case, the entire ' input data array is converted by default. New lines (CRLF) are inserted. Console.WriteLine(step3) s3 = Convert.ToBase64String(inArray, Base64FormattingOptions.InsertLineBreaks) ' 4) Test whether the methods in steps 2 and 3 produce the same result. Console.WriteLine(step4, s2.Equals(s3)) ' 5) Convert the base 64 string to an output array (outArray). Console.WriteLine(step5) outArray = Convert.FromBase64String(s2) ' 6) Is outArray equal to inArray? Console.WriteLine(step6, ArraysAreEqual(inArray, outArray)) End Sub 'Main Public Shared Function ArraysAreEqual(a1() As Byte, a2() As Byte) As Boolean If a1.Length <> a2.Length Then Return False End If Dim i As Integer For i = 0 To a1.Length - 1 If a1(i) <> a2(i) Then Return False End If Next i Return True End Function 'ArraysAreEqual End Class 'Sample ' 'This example produces the following results: ' '1) The input is a byte array (inArray) of arbitrary data. ' '00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 11 12 13 '14 15 16 17 18 19 1A 1B 1C 1D 1E 1F 20 21 22 23 24 25 26 27 '28 29 2A 2B 2C 2D 2E 2F 30 31 32 33 34 35 36 37 38 39 3A 3B '3C 3D 3E 3F 40 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F '50 51 52 53 54 55 56 57 58 59 5A 5B 5C 5D 5E 5F 60 61 62 63 '64 65 66 67 68 69 6A 6B 6C 6D 6E 6F 70 71 72 73 74 75 76 77 '78 79 7A 7B 7C 7D 7E 7F 80 81 82 83 84 85 86 87 88 89 8A 8B '8C 8D 8E 8F 90 91 92 93 94 95 96 97 98 99 9A 9B 9C 9D 9E 9F 'A0 A1 A2 A3 A4 A5 A6 A7 A8 A9 AA AB AC AD AE AF B0 B1 B2 B3 'B4 B5 B6 B7 B8 B9 BA BB BC BD BE BF C0 C1 C2 C3 C4 C5 C6 C7 'C8 C9 CA CB CC CD CE CF D0 D1 D2 D3 D4 D5 D6 D7 D8 D9 DA DB 'DC DD DE DF E0 E1 E2 E3 E4 E5 E6 E7 E8 E9 EA EB EC ED EE EF 'F0 F1 F2 F3 F4 F5 F6 F7 F8 F9 FA FB FC FD FE FF ' '2) Convert a subarray of the input data array to a base 64 string. ' ' 1 2 3 4 5 6 7 '1234567890123456789012345678901234567890123456789012345678901234567890123456 '----+----+----+----+----+----+----+----+----+----+----+----+----+----+----+- 'AAECAwQFBgcICQoLDA0ODxAREhMUFRYXGBkaGxwdHh8gISIjJCUmJygpKissLS4vMDEyMzQ1Njc4 'OTo7PD0+P0BBQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWltcXV5fYGFiY2RlZmdoaWprbG1ub3Bx 'cnN0dXZ3eHl6e3x9fn+AgYKDhIWGh4iJiouMjY6PkJGSk5SVlpeYmZqbnJ2en6ChoqOkpaanqKmq 'q6ytrq+wsbKztLW2t7i5uru8vb6/wMHCw8TFxsfIycrLzM3Oz9DR0tPU1dbX2Nna29zd3t/g4eLj '5OXm5+jp6uvs7e7v8PHy8/T19vf4+fr7/P3+/w== ' '3) Convert the entire input data array to a base 64 string. '4) The two methods in steps 2 and 3 produce the same result?: True '5) Convert the base 64 string to an output byte array (outArray). '6) The input and output arrays, inArray and outArray, are equal?: True '
// This example demonstrates the Convert.ToBase64String() and // Convert.FromBase64String() methods using System; class Sample { public static void Main() { byte[] inArray = new byte[256]; byte[] outArray = new byte[256]; string s2; string s3; string step1 = "1) The input is a byte array (inArray) of arbitrary data."; string step2 = "2) Convert a subarray of the input data array to a base 64 string."; string step3 = "3) Convert the entire input data array to a base 64 string."; string step4 = "4) The two methods in steps 2 and 3 produce the same result?: {0}"; string step5 = "5) Convert the base 64 string to an output byte array (outArray)."; string step6 = "6) The input and output arrays, inArray and outArray, are equal?: {0}"; int x; string nl = Environment.NewLine; string ruler1a = " 1 2 3 4"; string ruler2a = "1234567890123456789012345678901234567890"; string ruler3a = "----+----+----+----+----+----+----+----+"; string ruler1b = " 5 6 7 "; string ruler2b = "123456789012345678901234567890123456"; string ruler3b = "----+----+----+----+----+----+----+-"; string ruler = String.Concat(ruler1a, ruler1b, nl, ruler2a, ruler2b, nl, ruler3a, ruler3b, nl); // 1) Display an arbitrary array of input data (inArray). The data could be // derived from user input, a file, an algorithm, etc. Console.WriteLine(step1); Console.WriteLine(); for (x = 0; x < inArray.Length; x++) { inArray[x] = (byte)x; Console.Write("{0:X2} ", inArray[x]); if (((x+1)%20) == 0) Console.WriteLine(); } Console.Write("{0}{0}", nl); // 2) Convert a subarray of the input data to a base64 string. In this case, // the subarray is the entire input data array. New lines (CRLF) are inserted. Console.WriteLine(step2); s2 = Convert.ToBase64String(inArray, 0, inArray.Length, Base64FormattingOptions.InsertLineBreaks); Console.WriteLine("{0}{1}{2}{3}", nl, ruler, s2, nl); // 3) Convert the input data to a base64 string. In this case, the entire // input data array is converted by default. New lines (CRLF) are inserted. Console.WriteLine(step3); s3 = Convert.ToBase64String(inArray, Base64FormattingOptions.InsertLineBreaks); // 4) Test whether the methods in steps 2 and 3 produce the same result. Console.WriteLine(step4, s2.Equals(s3)); // 5) Convert the base 64 string to an output array (outArray). Console.WriteLine(step5); outArray = Convert.FromBase64String(s2); // 6) Is outArray equal to inArray? Console.WriteLine(step6, ArraysAreEqual(inArray, outArray)); } public static bool ArraysAreEqual(byte[] a1, byte[] a2) { if (a1.Length != a2.Length) return false; for (int i = 0; i < a1.Length; i++) if (a1[i] != a2[i]) return false; return true; } } /* This example produces the following results: 1) The input is a byte array (inArray) of arbitrary data. 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F 20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 30 31 32 33 34 35 36 37 38 39 3A 3B 3C 3D 3E 3F 40 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F 50 51 52 53 54 55 56 57 58 59 5A 5B 5C 5D 5E 5F 60 61 62 63 64 65 66 67 68 69 6A 6B 6C 6D 6E 6F 70 71 72 73 74 75 76 77 78 79 7A 7B 7C 7D 7E 7F 80 81 82 83 84 85 86 87 88 89 8A 8B 8C 8D 8E 8F 90 91 92 93 94 95 96 97 98 99 9A 9B 9C 9D 9E 9F A0 A1 A2 A3 A4 A5 A6 A7 A8 A9 AA AB AC AD AE AF B0 B1 B2 B3 B4 B5 B6 B7 B8 B9 BA BB BC BD BE BF C0 C1 C2 C3 C4 C5 C6 C7 C8 C9 CA CB CC CD CE CF D0 D1 D2 D3 D4 D5 D6 D7 D8 D9 DA DB DC DD DE DF E0 E1 E2 E3 E4 E5 E6 E7 E8 E9 EA EB EC ED EE EF F0 F1 F2 F3 F4 F5 F6 F7 F8 F9 FA FB FC FD FE FF 2) Convert a subarray of the input data array to a base 64 string. 1 2 3 4 5 6 7 1234567890123456789012345678901234567890123456789012345678901234567890123456 ----+----+----+----+----+----+----+----+----+----+----+----+----+----+----+- AAECAwQFBgcICQoLDA0ODxAREhMUFRYXGBkaGxwdHh8gISIjJCUmJygpKissLS4vMDEyMzQ1Njc4 OTo7PD0+P0BBQkNERUZHSElKS0xNTk9QUVJTVFVWV1hZWltcXV5fYGFiY2RlZmdoaWprbG1ub3Bx cnN0dXZ3eHl6e3x9fn+AgYKDhIWGh4iJiouMjY6PkJGSk5SVlpeYmZqbnJ2en6ChoqOkpaanqKmq q6ytrq+wsbKztLW2t7i5uru8vb6/wMHCw8TFxsfIycrLzM3Oz9DR0tPU1dbX2Nna29zd3t/g4eLj 5OXm5+jp6uvs7e7v8PHy8/T19vf4+fr7/P3+/w== 3) Convert the entire input data array to a base 64 string. 4) The two methods in steps 2 and 3 produce the same result?: True 5) Convert the base 64 string to an output byte array (outArray). 6) The input and output arrays, inArray and outArray, are equal?: True */
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- Base64FormattingOptions 列挙体のページへのリンク
