情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

Convert.FromBase64CharArray メソッド

2013/12/12

Unicode 文字配列のサブセットを変換します。これにより、バイナリ データは Base64 の数字として等価の 8 ビット符号なし整数配列にエンコードされます。パラメーターは、入力配列のサブセットと変換する要素の数を指定します。

Namespace:  System
アセンブリ:  mscorlib (mscorlib.dll 内)

public static byte[] FromBase64CharArray(
	char[] inArray,
	int offset,
	int length
)

パラメーター

inArray
型: System.Char []
Unicode 文字配列。
offset
型: System.Int32
inArray 内での位置。
length
型: System.Int32
変換する inArray の要素の数。

戻り値

型: System.Byte []
inArrayoffset の位置にある length 要素と等価の 8 ビット符号なし整数の配列。

例外条件
ArgumentNullException

inArraynull です。

ArgumentOutOfRangeException

offset または length が 0 未満です。

または

lengthoffset を足した数が、inArray 内に存在しない位置を示しています。

FormatException

空白文字を除いた inArray の長さが 0 ではないか、または 4 の倍数ではありません。

または

inArray の書式が無効です。inArray に Base64 形式以外の文字、2 つ以上の埋め込み文字、または埋め込み文字の間に空白以外の文字が含まれています。

inArray は、Base64 形式の文字、および空白文字で構成されます。ただし、それらの文字の後に、適切な長さになるように文字が埋め込まれます。Base64 形式の文字を 0 から昇順で並べると、大文字の "A" ~ "Z"、小文字の "a" ~ "z"、数字の "0" ~ "9"、および "+" と "/" の記号になります。

空白文字、およびそれらの Unicode 名と 16 進数のコード ポイントは、タブ (CHARACTER TABULATION、U+0009)、改行 (LINE FEED、U+000A)、復帰 (CARRIAGE RETURN、U+000D)、および空白 (SPACE、U+0020) です。空白文字はすべて無視されるため、任意の数の空白文字を inArray に含めることができます。

値として解釈されない文字 '=' は、文字列末尾の埋め込み用に使用されます。inArray の末尾は、1 つまたは 2 つの埋め込み文字で構成されます。

ToBase64CharArray メソッドの例を次に示します。入力は、3 バイト (24 ビット) ごとのグループに分けられます。したがって、各グループは、10 進数の 0 ~ 63 の範囲の 4 つの 6 ビット数値で構成されます。この例では、85 個の 3 バイトのグループがあり、1 バイトが残されています。最初のグループは、16 進値 00、01、02 で構成されます。これらは、10 進数の 0、0、4、2 に相当する 4 つの 6 ビット値を生成します。この 4 つの値は、出力の最初にある Base64 形式の文字 "A"、"A"、"E"、"C" に対応します。

3 バイトのグループの整数が存在しない場合は、残りのバイトに 0 が効率的に埋め込まれ、完全なグループが形成されます。この例では、最後のバイト値は 16 進数の FF です。最初の 6 ビットは 10 進数の 63 に相当し、出力の末尾にある Base64 形式の文字 "/" に対応します。次の 2 ビットには 0 が埋め込まれ、10 進数の 48 が生成されます。これは、Base64 形式の文字 "w" に対応します。最後の 2 つの 6 ビット値が埋め込まれます。これらは値として解釈されない埋め込み文字 "=" に対応します。


// This example demonstrates the Convert.ToBase64CharArray() and
//                               Convert.FromBase64CharArray methods

using System;

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      byte[] byteArray1 = new byte[256];
      byte[] byteArray2 = new byte[256];
      char[] charArray = new char[352];
      int charArrayLength;
      string nl = "\n";

      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);

      // 1) Initialize and display a Byte array of arbitrary data.
      outputBlock.Text += String.Format("1) Input: A Byte array of arbitrary data.{0}", nl) + "\n";
      for (int x = 0; x < byteArray1.Length; x++)
      {
         byteArray1[x] = (byte)x;
         outputBlock.Text += String.Format("{0:X2} ", byteArray1[x]);
         if (((x + 1) % 20) == 0) outputBlock.Text += "\n";
      }
      outputBlock.Text += String.Format("{0}{0}", nl);

      // 2) Convert the input Byte array to a Char array, with newlines inserted.
      charArrayLength =
          Convert.ToBase64CharArray(byteArray1, 0, byteArray1.Length,
                                     charArray, 0);
      outputBlock.Text += "2) Convert the input Byte array to a Char array." + "\n";
      outputBlock.Text += String.Format("   Output: A Char array (length = {0}). ", charArrayLength);
      outputBlock.Text += String.Format("The elements of the array are:{0}", nl) + "\n";
      outputBlock.Text += ruler + "\n";
      outputBlock.Text += new String(charArray) + "\n";
      outputBlock.Text += "\n";

      // 3) Convert the Char array back to a Byte array.
      outputBlock.Text += "3) Convert the Char array to an output Byte array." + "\n";
      byteArray2 = Convert.FromBase64CharArray(charArray, 0, charArrayLength);

      // 4) Are the input and output Byte arrays equivalent?
      outputBlock.Text += String.Format("4) The output Byte array is equal to the input Byte array?: {0}",
                        ArraysAreEqual(byteArray1, byteArray2)) + "\n";
   }

   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) Input: A Byte array 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 the input Byte array to a Char array.
   Output: A Char array (length = 352). The elements of the array are:

         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 Char array to an output Byte array.
4) The output Byte array is equal to the input Byte array?: True

*/


Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示: