UTF32Encoding-Klasse

Beim Codieren werden Unicode-Zeichen in eine Bytefolge transformiert. Beim Decodieren wird eine Folge codierter Bytes in Unicode-Zeichen transformiert.

Die UTF-32-Codierung stellt jeden Codepunkt als 32-Bit-Ganzzahl dar. Weitere Informationen zu den UTFs und anderen von System.Text unterstützten Codierungen finden Sie unter Zeichencodierung in .NET Framework und Verwenden der Unicode-Codierung.

Die GetByteCount-Methode bestimmt, wie viele Bytes sich beim Codieren einer Reihe von Unicode-Zeichen ergeben, und die GetBytes-Methode führt die eigentliche Codierung durch.

Ebenso bestimmt die GetCharCount-Methode, wie viele Zeichen sich aus der Decodierung einer Bytefolge ergeben, und die GetChars-Methode und die GetString-Methode führen die eigentliche Decodierung aus.

UTF32Encoding entspricht den Windows-Codepages 12000 (Little-Endian-Bytereihenfolge) und 12001 (Big-Endian-Bytereihenfolge).

Der Encoder kann die Big-Endian-Bytereihenfolge (mit dem höchstwertigen Byte an erster Stelle) oder die Little-Endian-Bytereihenfolge (mit dem niederwertigsten Byte an erster Stelle) verwenden. Beispielsweise wird der lateinische Großbuchstabe A (Codepunkt U+0041) wie folgt serialisiert (Hexadezimalwert):

• Big-Endian-Bytereihenfolge: 00 00 00 41

• Little-Endian-Bytereihenfolge: 41 00 00 00

Im Allgemeinen ist es effizienter, Unicode-Zeichen in der systemeigenen Bytereihenfolge zu speichern. Beispielsweise ist es besser, die Little-Endian-Bytereihenfolge auf entsprechenden Plattformen, z. B. auf Intel-Computern, zu verwenden.

Die GetPreamble-Methode ruft ein Bytearray zurück, das die Bytereihenfolgemarkierung (Byte Order Mark, BOM) enthalten kann. Wenn dieses Bytearray einem codierten Stream vorangestellt ist, unterstützt es den Decoder bei der Ermittlung des verwendeten Codierungsformats.

Weitere Informationen zur Bytereihenfolge und zur Bytereihenfolgemarkierung finden Sie im Unicode-Standard auf der Unicode-Homepage (auf Englisch).

Hinweis

Um die Fehlererkennung zu aktivieren und die Sicherheit der Klasseninstanz zu erhöhen, sollte die Anwendung den UTF32Encoding-Konstruktor verwenden, der einen throwOnInvalidCharacters-Parameter annimmt, und diesen Parameter auf true festlegen. Bei aktivierter Fehlererkennung löst eine Methode, die eine ungültige Zeichenfolge erkennt, eine ArgumentException-Ausnahme aus. Ohne Fehlererkennung wird keine Ausnahme ausgelöst, und die ungültige Sequenz wird meist ignoriert.

Im folgenden Codebeispiel wird das Verhalten von UTF32Encoding bei aktivierter und bei deaktivierter Fehlererkennung veranschaulicht.

using System;
using System.Text;

public class SamplesUTF32Encoding  {

   public static void Main()  {

      // Create an instance of UTF32Encoding using little-endian byte order.
      // This will be used for encoding.
      UTF32Encoding u32LE     = new UTF32Encoding( false, true );

      // Create two instances of UTF32Encoding using big-endian byte order: one with error detection and one without.
      // These will be used for decoding.
      UTF32Encoding u32withED = new UTF32Encoding( true, true, true );
      UTF32Encoding u32noED   = new UTF32Encoding( true, true, false );

      // Create byte arrays from the same string containing the following characters:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    a high-surrogate value (U+D8FF)
      //    a low-surrogate value (U+DCFF)
      String myStr = "za\u0306\u01FD\u03B2\uD8FF\uDCFF";

      // Encode the string using little-endian byte order.
      byte[] myBytes = new byte[u32LE.GetByteCount( myStr )];
      u32LE.GetBytes( myStr, 0, myStr.Length, myBytes, 0 );

      // Decode the byte array with error detection.
      Console.WriteLine( "Decoding with error detection:" );
      PrintDecodedString( myBytes, u32withED );

      // Decode the byte array without error detection.
      Console.WriteLine( "Decoding without error detection:" );
      PrintDecodedString( myBytes, u32noED );

   }


   // Decode the bytes and display the string.
   public static void PrintDecodedString( byte[] bytes, Encoding enc )  {

      try  {
         Console.WriteLine( "   Decoded string: {0}", enc.GetString( bytes, 0, bytes.Length ) );
      }
      catch ( System.ArgumentException e )  {
         Console.WriteLine( e.ToString() );
      }

      Console.WriteLine();

   }

}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz

Weitere Ressourcen