Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Enumerazione Base64FormattingOptions

 

Data di pubblicazione: novembre 2016

Specifica se i metodi rilevanti Convert.ToBase64CharArray e Convert.ToBase64String inseriscono un'interruzione di riga nell'output.

Questa enumerazione ha un attributo FlagsAttribute che consente una combinazione bit per bit dei relativi valori dei membri.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

[FlagsAttribute]
public enum Base64FormattingOptions

Nome membroDescrizione
InsertLineBreaks

Inserisce interruzioni di riga ogni 76 caratteri nella rappresentazione della stringa.

None

Non inserisce interruzioni di riga ogni 76 caratteri nella rappresentazione della stringa.

Il Convert.ToBase64CharArray e Convert.ToBase64String metodi consentono di convertire il valore di una matrice di interi senza segno a 8 bit in una rappresentazione di stringa equivalente con cifre base 64. La rappresentazione di stringa può contenere uno o più interruzioni di riga, dove un'interruzione di riga è definita come un ritorno a capo restituiscano il carattere (U + 000D) seguito da un carattere di avanzamento riga (U + 000A). Poiché le interruzioni di riga sono considerate spazi vuoti in una codifica base 64, vengono ignorati quando la conversione di una base 64 in una stringa in una matrice di byte codificata. Le interruzioni di riga sono semplicemente utile quando si visualizza la stringa codificata in un controllo o un dispositivo, ad esempio una finestra della console.

I valori di Base64FormattingOptions.None e Base64FormattingOptions.InsertLineBreaks si escludono a vicenda. Pertanto, sebbene l'enumerazione Base64FormattingOptions sia contrassegnata con l'attributo FlagsAttribute, non ha senso eseguire una combinazione bit per bit di questi due valori.

Nell'esempio seguente viene chiamato il Convert.ToBase64String(Byte[], Base64FormattingOptions) con un Base64FormattingOptions.InsertLineBreaks interruzioni di argomento per inserire una riga nella stringa di prodotti dalla codifica di una matrice di byte a 100 elementi.

using System;

public class Example
{
   public static void Main()
   {
       // Define a byte array.
       Byte[] 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 sring.
       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

As the output from the example shows, the M:System.Convert.FromBase64String(System.String) succeeds in restoring the original byte array; the line break characters are ignored during the conversion.

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: