Convert.ToBase64String Yöntem

Tanım

8 bit işaretsiz tamsayılar dizisinin değerini, taban-64 basamakla kodlanmış eşdeğer dize gösterimine dönüştürür.

Aşırı Yüklemeler

ToBase64String(Byte[])

8 bit işaretsiz tamsayılardan oluşan bir diziyi, taban-64 basamaklı kodlanmış eşdeğer dize gösterimine dönüştürür.

ToBase64String(Byte[], Base64FormattingOptions)

8 bit işaretsiz tamsayılardan oluşan bir diziyi, taban-64 basamaklı kodlanmış eşdeğer dize gösterimine dönüştürür. Dönüş değerine satır sonları eklenip eklenmeyeceğini belirtebilirsiniz.

ToBase64String(ReadOnlySpan<Byte>, Base64FormattingOptions)

Belirtilen salt okunur yayılma alanı içindeki 8 bit işaretsiz tamsayıları, taban-64 basamaklarla kodlanmış eşdeğer dize gösterimine dönüştürür. İsteğe bağlı olarak, dönüş değerine satır sonları eklenip eklenmeyeceğini belirtebilirsiniz.

ToBase64String(Byte[], Int32, Int32)

8 bit işaretsiz tamsayılar dizisinin alt kümesini, taban-64 basamaklı kodlanmış eşdeğer dize gösterimine dönüştürür. Parametreler, giriş dizisinde uzaklık olarak alt kümeyi ve dönüştürülecek dizideki öğelerin sayısını belirtir.

ToBase64String(Byte[], Int32, Int32, Base64FormattingOptions)

8 bit işaretsiz tamsayılar dizisinin alt kümesini, taban-64 basamaklı kodlanmış eşdeğer dize gösterimine dönüştürür. Parametreler alt kümeyi giriş dizisinde uzaklık olarak, dönüştürülecek dizideki öğelerin sayısını ve dönüş değerine satır sonlarının eklenip eklenmeyeceğini belirtir.

ToBase64String(Byte[])

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

8 bit işaretsiz tamsayılardan oluşan bir diziyi, taban-64 basamaklı kodlanmış eşdeğer dize gösterimine dönüştürür.

public static string ToBase64String (byte[] inArray);

Parametreler

inArray
Byte[]

8 bit işaretsiz tamsayılardan oluşan bir dizi.

Döndürülenler

inArrayiçeriğinin 64 tabanında dize gösterimi.

Özel durumlar

inArray null.

Örnekler

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

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. Ardından BitConverter.GetBytes(Int32) yöntemini kullanarak her öğeyi bir bayt dizisine dönüştürür ve Array.Copy(Array, Int32, Array, Int32, Int32) yöntemini çağırarak bir arabellekte uygun konumda depolar. Bu arabellek daha sonra UUencoded (base-64) dizesi oluşturmak için ToBase64String(Byte[]) yöntemine geçirilir. Ardından UUencoded dizesinin kodunu çözmek için FromBase64String(String) yöntemini çağırır ve dört baytlık her kümeyi (32 bit tamsayı boyutu) tamsayıya dönüştürmek için BitConverter.ToInt32 yöntemini çağırır. Örnekten elde edilen çıkış, özgün dizinin başarıyla geri yüklendiğini gösterir.

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

inArray öğeleri sayısal bir değer olarak alınır ve taban-64 basamaklı kodlanmış bir dize gösterimine dönüştürülür.

Sıfırdan artan düzende 64 tabanındaki basamaklar büyük harf "A" ile "Z" arasında, küçük harfli "a" ile "z" arası karakterler, "0" ile "9" arasında sayılar ve "+" ve "/" simgeleridir. "=" değeri olmayan karakter, sondaki doldurma için kullanılır.

Önemli

ToBase64String yöntemi, kodlanacak tüm verileri içeren tek bir bayt dizisini işlemek için tasarlanmıştır. Bir akıştan verileri kodlamak için System.Security.Cryptography.ToBase64Transform sınıfını kullanın.

Normalde, ToBase64String yöntemi UUEncoded (base-64 kodlanmış) dizesini gidiş dönüş yapmak için kullanılmaz. Diğer bir ifadeyle, FromBase64String yöntemini çağırarak bir dizenin kodunu çözer ve ardından ToBase64String yöntemini çağırarak döndürülen bayt dizisini kodlarsanız, sonuçta elde edilen dize özgün dizeyle aynı olmayabilir. Dize yalnızca özgün dize geçerli bir base-64 kodlanmış dizeyse gidiş dönüş yapar.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBase64String(Byte[], Base64FormattingOptions)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

8 bit işaretsiz tamsayılardan oluşan bir diziyi, taban-64 basamaklı kodlanmış eşdeğer dize gösterimine dönüştürür. Dönüş değerine satır sonları eklenip eklenmeyeceğini belirtebilirsiniz.

public static string ToBase64String (byte[] inArray, Base64FormattingOptions options);
[System.Runtime.InteropServices.ComVisible(false)]
public static string ToBase64String (byte[] inArray, Base64FormattingOptions options);

Parametreler

inArray
Byte[]

8 bit işaretsiz tamsayılardan oluşan bir dizi.

options
Base64FormattingOptions

Her 76 karakterde bir satır sonu eklemek InsertLineBreaks veya satır sonu eklememek için None.

Döndürülenler

inArrayiçindeki öğelerin 64 tabanındaki dize gösterimi.

Öznitelikler

Özel durumlar

inArray null.

options geçerli bir Base64FormattingOptions değeri değil.

Örnekler

Aşağıdaki örnek, 100 öğeli bayt dizisi kodlanarak oluşturulan dizeye satır sonları eklemek için Base64FormattingOptions.InsertLineBreaks bağımsız değişkeniyle Convert.ToBase64String(Byte[], Base64FormattingOptions) çağırır.

using System;

public class Example
{
   public static void Main()
   {
       // Define a byte array.
       var bytes = new byte[100];
       int originalTotal = 0;
       for (int ctr = 0; ctr <= bytes.GetUpperBound(0); ctr++) {
          bytes[ctr] = (byte)(ctr + 1);
          originalTotal += bytes[ctr];
       }
       // Display summary information about the array.
       Console.WriteLine("The original byte array:");
       Console.WriteLine("   Total elements: {0}", bytes.Length);
       Console.WriteLine("   Length of String Representation: {0}",
                         BitConverter.ToString(bytes).Length);
       Console.WriteLine("   Sum of elements: {0:N0}", originalTotal);
       Console.WriteLine();

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

       // Restore the byte array.
       Byte[] newBytes = Convert.FromBase64String(s);
       int newTotal = 0;
       foreach (var newByte in newBytes)
          newTotal += newByte;

       // Display summary information about the restored array.
       Console.WriteLine("   Total elements: {0}", newBytes.Length);
       Console.WriteLine("   Length of String Representation: {0}",
                         BitConverter.ToString(newBytes).Length);
       Console.WriteLine("   Sum of elements: {0:N0}", newTotal);
   }
}
// The example displays the following output:
//   The original byte array:
//      Total elements: 100
//      Length of String Representation: 299
//      Sum of elements: 5,050
//
//   The base 64 string:
//      AQIDBAUGBwgJCgsMDQ4PEBESExQVFhcYGRobHB0eHyAhIiMkJSYnKCkqKywtLi8wMTIzNDU2Nzg5
//   Ojs8PT4/QEFCQ0RFRkdISUpLTE1OT1BRUlNUVVZXWFlaW1xdXl9gYWJjZA==
//
//      Total elements: 100
//      Length of String Representation: 299
//      Sum of elements: 5,050

Örnekteki çıktıda gösterildiği gibi, Convert.FromBase64String özgün bayt dizisini geri yüklemede başarılı olur; satır sonu karakterleri dönüştürme sırasında yoksayılır.

Açıklamalar

inArray parametresinin öğeleri sayısal bir değer olarak alınır ve 64 tabanındaki bir dize gösterimine dönüştürülür.

Sıfırdan artan düzende 64 tabanındaki basamaklar büyük harf "A" ile "Z" arasında, küçük harfli "a" ile "z" arası karakterler, "0" ile "9" arasında sayılar ve "+" ve "/" simgeleridir. "=" değersiz karakteri sondaki doldurma için kullanılır.

Önemli

ToBase64String yöntemi, kodlanacak tüm verileri içeren tek bir bayt dizisini işlemek için tasarlanmıştır. Bir akıştan verileri kodlamak için System.Security.Cryptography.ToBase64Transform sınıfını kullanın.

options parametresi InsertLineBreaks olarak ayarlanırsa ve dönüştürmenin çıkışı 76 karakterden uzunsa, her 76 karakterde bir satır sonu eklenir. Satır sonu, satır başı karakteri (U+000D) ve ardından satır besleme karakteri (U+000A) olarak tanımlanır. Satır sonları, base-64 kodlamasında boşluk karakterleri olarak kabul edildiğinden, base-64 kodlamalı bir dize yeniden bayt dizisine dönüştürülürken yoksayılır. Satır sonları, kodlanmış dizeyi bir denetime veya konsol penceresi gibi bir cihaza görüntülerken kullanışlıdır. Daha fazla bilgi için, https://www.rfc-editor.org/adresinde rfc 2045, "Çok Amaçlı İnternet Posta Uzantıları" bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ToBase64String(ReadOnlySpan<Byte>, Base64FormattingOptions)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen salt okunur yayılma alanı içindeki 8 bit işaretsiz tamsayıları, taban-64 basamaklarla kodlanmış eşdeğer dize gösterimine dönüştürür. İsteğe bağlı olarak, dönüş değerine satır sonları eklenip eklenmeyeceğini belirtebilirsiniz.

public static string ToBase64String (ReadOnlySpan<byte> bytes, Base64FormattingOptions options = System.Base64FormattingOptions.None);

Parametreler

bytes
ReadOnlySpan<Byte>

8 bit işaretsiz tamsayılardan oluşan salt okunur bir aralık.

options
Base64FormattingOptions

Dönüş değerine satır sonları eklenip eklenmeyeceğini belirten numaralandırma değerlerinden biri. Varsayılan değer None.

Döndürülenler

bytesiçindeki öğelerin 64 tabanındaki dize gösterimi. bytes uzunluğu 0 ise boş bir dize döndürülür.

Özel durumlar

options geçerli bir Base64FormattingOptions değeri değil.

Çıkış uzunluğu, Int32.MaxValuedeğerinden daha uzundu.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

ToBase64String(Byte[], Int32, Int32)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

8 bit işaretsiz tamsayılar dizisinin alt kümesini, taban-64 basamaklı kodlanmış eşdeğer dize gösterimine dönüştürür. Parametreler, giriş dizisinde uzaklık olarak alt kümeyi ve dönüştürülecek dizideki öğelerin sayısını belirtir.

public static string ToBase64String (byte[] inArray, int offset, int length);

Parametreler

inArray
Byte[]

8 bit işaretsiz tamsayılardan oluşan bir dizi.

offset
Int32

inArraybir uzaklık.

length
Int32

Dönüştürülecek inArray öğelerinin sayısı.

Döndürülenler

offsetkonumundan başlayarak inArrayöğelerinin length 64 tabanındaki dize gösterimi.

Özel durumlar

inArray null.

offset veya length negatiftir.

-veya-

offset artı lengthinArrayuzunluğundan büyüktür.

Açıklamalar

inArray öğeleri sayısal bir değer olarak alınır ve 64 tabanında dize gösterimine dönüştürülür.

Sıfırdan artan düzende 64 tabanındaki basamaklar büyük harf "A" ile "Z" arasında, küçük harfli "a" ile "z" arası karakterler, "0" ile "9" arasında sayılar ve "+" ve "/" simgeleridir. "=" değeri olmayan karakter, sondaki doldurma için kullanılır.

offset ve length parametreleri 32 bit imzalı sayılardır. offset parametresi sıfır tabanlıdır.

Önemli

ToBase64String yöntemi, kodlanacak tüm verileri içeren tek bir bayt dizisini işlemek için tasarlanmıştır. Bir akıştan verileri kodlamak için System.Security.Cryptography.ToBase64Transform sınıfını kullanın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBase64String(Byte[], Int32, Int32, Base64FormattingOptions)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

8 bit işaretsiz tamsayılar dizisinin alt kümesini, taban-64 basamaklı kodlanmış eşdeğer dize gösterimine dönüştürür. Parametreler alt kümeyi giriş dizisinde uzaklık olarak, dönüştürülecek dizideki öğelerin sayısını ve dönüş değerine satır sonlarının eklenip eklenmeyeceğini belirtir.

public static string ToBase64String (byte[] inArray, int offset, int length, Base64FormattingOptions options);
[System.Runtime.InteropServices.ComVisible(false)]
public static string ToBase64String (byte[] inArray, int offset, int length, Base64FormattingOptions options);

Parametreler

inArray
Byte[]

8 bit işaretsiz tamsayılardan oluşan bir dizi.

offset
Int32

inArraybir uzaklık.

length
Int32

Dönüştürülecek inArray öğelerinin sayısı.

options
Base64FormattingOptions

Her 76 karakterde bir satır sonu eklemek InsertLineBreaks veya satır sonu eklememek için None.

Döndürülenler

offsetkonumundan başlayarak inArrayöğelerinin length 64 tabanındaki dize gösterimi.

Öznitelikler

Özel durumlar

inArray null.

offset veya length negatiftir.

-veya-

offset artı lengthinArrayuzunluğundan büyüktür.

options geçerli bir Base64FormattingOptions değeri değil.

Örnekler

Aşağıdaki örnekte ToBase64String yöntemi gösterilmektedir. Giriş, her biri üç baytlık (24 bit) gruplara ayrılır. Sonuç olarak, her grup, her sayının ondalık 0 ile 63 arasında olduğu dört 6 bitlik sayıdan oluşur. Bu örnekte, bir bayt kalan 85 adet 3 baytlık grup vardır. İlk grup, ondalık 0, 0, 4 ve 2'ye eşit dört 6 bit değer veren 00, 01 ve 02 onaltılık değerlerden oluşur. Bu dört değer çıkışın başındaki "A", "A", "E" ve "C" taban 64 basamağına karşılık gelir.

3 baytlık grupların tamsayı sayısı yoksa, kalan baytlar tam bir grup oluşturmak için sıfırlarla etkin bir şekilde doldurulur. Bu örnekte, son bayt değeri onaltılık FF'dir. İlk 6 bit, çıkışın sonundaki taban-64 basama "/" karşılık gelen ondalık 63'e eşittir ve sonraki 2 bit ondalık 48'i vermek için sıfırlarla doldurulur ve bu da "w" taban-64 basama karşılık gelir. Son iki 6 bit değer doldurmadır ve "=" değersiz doldurma karakterine karşılık gelir.

// 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

*/

Açıklamalar

inArray parametresinin öğeleri sayısal bir değer olarak alınır ve 64 tabanındaki bir dize gösterimine dönüştürülür.

Sıfırdan artan düzende 64 tabanındaki basamaklar büyük harf "A" ile "Z" arasında, küçük harfli "a" ile "z" arası karakterler, "0" ile "9" arasında sayılar ve "+" ve "/" simgeleridir. "=" değersiz karakteri sondaki doldurma için kullanılır.

offset ve length parametreleri 32 bit imzalı sayılardır. offset parametresi sıfır tabanlıdır.

Önemli

ToBase64String yöntemi, kodlanacak tüm verileri içeren tek bir bayt dizisini işlemek için tasarlanmıştır. Bir akıştan verileri kodlamak için System.Security.Cryptography.ToBase64Transform sınıfını kullanın.

options parametresi InsertLineBreaks olarak ayarlanırsa ve dönüştürmenin çıkışı 76 karakterden uzunsa, her 76 karakterde bir satır sonu eklenir. Satır sonu, satır başı karakteri (U+000D) ve ardından satır besleme karakteri (U+000A) olarak tanımlanır. Daha fazla bilgi için, https://www.rfc-editor.org/adresinde rfc 2045, "Çok Amaçlı İnternet Posta Uzantıları" bölümüne bakın.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1