Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Base64FormattingOptions énumération

 

Date de publication : novembre 2016

Spécifie si les méthodes Convert.ToBase64CharArray et Convert.ToBase64String pertinentes insèrent des sauts de ligne dans leur résultat.

Cette énumération possède un attribut FlagsAttribute qui permet une combinaison d’opérations de bits de ses valeurs membres.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

[FlagsAttribute]
public enum Base64FormattingOptions

Nom du membreDescription
InsertLineBreaks

Insère des sauts de ligne tous les 76 caractères dans la représentation sous forme de chaîne.

None

N’insère pas de sauts de ligne tous les 76 caractères dans la représentation sous forme de chaîne.

Le Convert.ToBase64CharArray et Convert.ToBase64String méthodes convertissent la valeur d’un tableau d’entiers non signés 8 bits en une représentation sous forme de chaîne équivalente qui se compose de chiffres en base 64. La représentation sous forme de chaîne peut contenir un ou plusieurs sauts de ligne, où un saut de ligne est défini comme un transport retournent chariot (U + 000D) suivi d’un caractère (U + 000D) de saut de ligne. Étant donné que les sauts de ligne sont considérés comme des caractères d’espace blanc dans un codage en base 64, elles sont ignorées lors de la conversion en base 64 de la chaîne en un tableau d’octets encodée. Les sauts de ligne sont simplement pratiques lors de l’affichage de la chaîne encodée à un contrôle ou un périphérique tel qu’une fenêtre de console.

Le Base64FormattingOptions.None et Base64FormattingOptions.InsertLineBreaks valeurs s’excluent mutuellement. Par conséquent, bien que le Base64FormattingOptions énumération est marquée avec la FlagsAttribute attribut, il n’est pas justifiée pour effectuer une combinaison de ces deux valeurs.

L’exemple suivant appelle la Convert.ToBase64String(Byte[], Base64FormattingOptions) avec un Base64FormattingOptions.InsertLineBreaks argument pour insérer la ligne s’arrête dans la chaîne qui est générée par l’encodage d’un tableau d’octets de 100 éléments.

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
Disponible depuis 2.0
Retour au début
Afficher: