Convert.FromBase64String(String) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.Extensions.dll

Bütünleştirilmiş Kod:

System.Runtime.dll

Bütünleştirilmiş Kod:

mscorlib.dll

Bütünleştirilmiş Kod:

netstandard.dll

İkili verileri taban-64 basamak olarak kodlayan belirtilen dizeyi eşdeğer bir 8 bit işaretsiz tamsayı dizisine dönüştürür.

C#

public static byte[] FromBase64String (string s);

Parametreler

s

String

Dönüştürülecek dize.

Döndürülenler

Byte[]

ile eşdeğer s8 bit işaretsiz tamsayılardan oluşan bir dizi.

Özel durumlar

ArgumentNullException

s, null değeridir.

FormatException

sBoşluk karakterleri yoksayılarak uzunluğu sıfır veya 4'ün katı değildir.

-veya-

biçimi s geçersiz. s , 64 tabanı olmayan bir karakter, ikiden fazla doldurma karakteri veya doldurma karakterleri arasında boşluk olmayan bir karakter içerir.

Örnekler

Aşağıdaki örnek, bir bayt dizisini ToBase64String(Byte[]) UUencoded (base-64) dizesine dönüştürmek için yöntemini kullanır ve ardından özgün bayt dizisini geri yüklemek için yöntemini çağırır FromBase64String(String) .

C#

using System;

public class Example
{
   public static void Main()
   {
       // Define a byte array.
       byte[] bytes = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20 };
       Console.WriteLine("The byte array: ");
       Console.WriteLine("   {0}\n", BitConverter.ToString(bytes));

       // Convert the array to a base 64 string.
       string s = Convert.ToBase64String(bytes);
       Console.WriteLine("The base 64 string:\n   {0}\n", s);

       // Restore the byte array.
       byte[] newBytes = Convert.FromBase64String(s);
       Console.WriteLine("The restored byte array: ");
       Console.WriteLine("   {0}\n", BitConverter.ToString(newBytes));
   }
}
// The example displays the following output:
//     The byte array:
//        02-04-06-08-0A-0C-0E-10-12-14
//
//     The base 64 string:
//        AgQGCAoMDhASFA==
//
//     The restored byte array:
//        02-04-06-08-0A-0C-0E-10-12-14

Aşağıda, 32 bit tamsayılardan oluşan 20 öğeli bir dizi oluşturan daha karmaşık bir örnek verilmiştir. Daha sonra yöntemini kullanarak BitConverter.GetBytes(Int32) her öğeyi bir bayt dizisine dönüştürür ve bunu yöntemi çağırarak Array.Copy(Array, Int32, Array, Int32, Int32) bir arabellekte uygun konumda depolar. Bu arabellek daha sonra yöntemine ToBase64String(Byte[]) geçirilir ve UUencoded (base-64) dizesi oluşturulur. Ardından UUencoded dizesinin kodunu çözmek için yöntemini çağırır FromBase64String(String) ve dört baytlık her kümeyi BitConverter.ToInt32 (32 bit tamsayı boyutu) tamsayıya dönüştürmek için yöntemini çağırır. Örnekten elde edilen çıkış, özgün dizinin başarıyla geri yüklendiğini gösterir.

C#

using System;

public class Example
{
   public static void Main()
   {
      // Define an array of 20 elements and display it.
      int[] arr = new int[20];
      int value = 1;
      for (int ctr = 0; ctr <= arr.GetUpperBound(0); ctr++) {
         arr[ctr] = value;
         value = value * 2 + 1;
      }
      DisplayArray(arr);

      // Convert the array of integers to a byte array.
      byte[] bytes = new byte[arr.Length * 4];
      for (int ctr = 0; ctr < arr.Length; ctr++) {
         Array.Copy(BitConverter.GetBytes(arr[ctr]), 0,
                    bytes, ctr * 4, 4);
      }

      // Encode the byte array using Base64 encoding
      String base64 = Convert.ToBase64String(bytes);
      Console.WriteLine("The encoded string: ");
      for (int ctr = 0; ctr <= base64.Length / 50; ctr++)
         Console.WriteLine(base64.Substring(ctr * 50,
                                            ctr * 50 + 50 <= base64.Length
                                               ? 50 : base64.Length - ctr * 50));
      Console.WriteLine();

      // Convert the string back to a byte array.
      byte[] newBytes = Convert.FromBase64String(base64);

      // Convert the byte array back to an integer array.
      int[] newArr = new int[newBytes.Length/4];
      for (int ctr = 0; ctr < newBytes.Length / 4; ctr ++)
         newArr[ctr] = BitConverter.ToInt32(newBytes, ctr * 4);

      DisplayArray(newArr);
   }

   private static void DisplayArray(Array arr)
   {
      Console.WriteLine("The array:");
      Console.Write("{ ");
      for (int ctr = 0; ctr < arr.GetUpperBound(0); ctr++) {
         Console.Write("{0}, ", arr.GetValue(ctr));
         if ((ctr + 1) % 10 == 0)
            Console.Write("\n  ");
      }
      Console.WriteLine("{0} {1}", arr.GetValue(arr.GetUpperBound(0)), "}");
      Console.WriteLine();
   }
}
// The example displays the following output:
// The array:
// { 1, 3, 7, 15, 31, 63, 127, 255, 511, 1023,
//   2047, 4095, 8191, 16383, 32767, 65535, 131071, 262143, 524287, 1048575 }
//
// The encoded string:
// AQAAAAMAAAAHAAAADwAAAB8AAAA/AAAAfwAAAP8AAAD/AQAA/w
// MAAP8HAAD/DwAA/x8AAP8/AAD/fwAA//8AAP//AQD//wMA//8H
//
// The array:
// { 1, 3, 7, 15, 31, 63, 127, 255, 511, 1023,
//   2047, 4095, 8191, 16383, 32767, 65535, 131071, 262143, 524287, 1048575 }

Açıklamalar

s 64 tabanındaki basamaklardan, boşluk karakterlerinden ve sondaki doldurma karakterlerinden oluşur. Sıfırdan artan düzende 64 rakamı büyük harf olan "A" ile "Z", küçük harfli "a" ile "z" arasındaki karakterler, "0" ile "9" arasındaki sayılar ve "+" ve "/" simgeleridir.

Boşluk karakterleri ve bunların Unicode adları ve onaltılık kod noktaları sekme (KARAKTER TABULATION, U+0009), yeni satır (LINE FEED, U+000A), satır başı (CARRIAGE RETURN, U+000D) ve boş (ARA ÇUBUĞU, U+0020). Tüm boşluk karakterleri yoksayıldığı için içinde rastgele sayıda boşluk karakteri görüntülenebilir s .

Değersiz "=" karakteri sonda doldurma için kullanılır. sonu s sıfır, bir veya iki doldurma karakterinden oluşabilir.

Önemli

FromBase64String yöntemi, çözülecek tüm verileri içeren tek bir dizeyi işlemek için tasarlanmıştır. Bir akıştan base-64 karakter verilerinin kodunu çözmek için sınıfını System.Security.Cryptography.FromBase64Transform kullanın.

Şunlara uygulanır

Ayrıca bkz.

• ToBase64String(Byte[])
• FromBase64Transform