UTF32Encoding Třída

Definice

Představuje kódování UTF-32 znaků Unicode.

public ref class UTF32Encoding sealed : System::Text::Encoding
public sealed class UTF32Encoding : System.Text.Encoding
[System.Serializable]
public sealed class UTF32Encoding : System.Text.Encoding
type UTF32Encoding = class
    inherit Encoding
[<System.Serializable>]
type UTF32Encoding = class
    inherit Encoding
Public NotInheritable Class UTF32Encoding
Inherits Encoding
Dědičnost
UTF32Encoding
Atributy

Příklady

Následující příklad ukazuje chování objektů s povolenou UTF32Encoding a bez detekce chyb. Vytvoří pole bajtů, jehož poslední čtyři bajty představují neplatnou náhradní dvojici; za vysokou náhradou U+D8FF následuje U+01FF, který je mimo rozsah nízkých náhrad (0xDC00 až 0xDFFF). Dekodér UTF32 bez detekce chyb použije náhradní náhradní pár k nahrazení neplatného náhradního páru za U+FFFD (REPLACEMENT CHARACTER).

using namespace System;
using namespace System::Text;
void PrintDecodedString( array<Byte>^bytes, Encoding^ enc );
int main()
{
   
   // Create an instance of UTF32Encoding using little-endian byte order.
   // This will be used for encoding.
   UTF32Encoding^ u32LE = gcnew 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 = gcnew UTF32Encoding( true,true,true );
   UTF32Encoding^ u32noED = gcnew 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)
   String^ myStr = L"za\u0306\u01FD\u03B2\xD8FF\xDCFF";
   
   // Encode the string using little-endian byte order.
   array<Byte>^myBytes = gcnew array<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.
void PrintDecodedString( array<Byte>^bytes, Encoding^ enc )
{
   try
   {
      Console::WriteLine( "   Decoded string: {0}", enc->GetString( bytes, 0, bytes->Length ) );
   }
   catch ( System::ArgumentException^ e ) 
   {
      Console::WriteLine( e );
   }

   Console::WriteLine();
}
using System;
using System.Text;

public class Example
{
   public static void Main()
   {
     // Create a UTF32Encoding object with error detection enabled.
      var encExc = new UTF32Encoding(! BitConverter.IsLittleEndian, true, true);
      // Create a UTF32Encoding object with error detection disabled.
      var encRepl = new UTF32Encoding(! BitConverter.IsLittleEndian, true, false);

      // Create a byte arrays from a string, and add an invalid surrogate pair, as follows.
      //    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)
      //    an invalid low surrogate (U+01FF)
      String s = "za\u0306\u01FD\u03B2";

      // Encode the string using little-endian byte order.
      int index = encExc.GetByteCount(s);
      Byte[] bytes = new Byte[index + 4];
      encExc.GetBytes(s, 0, s.Length, bytes, 0);
      bytes[index] = 0xFF;
      bytes[index + 1] = 0xD8;
      bytes[index + 2] = 0xFF;
      bytes[index + 3] = 0x01;

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

      // Decode the byte array without error detection.
      Console.WriteLine("Decoding without error detection:");
      PrintDecodedString(bytes, encRepl);
   }

   // 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 (DecoderFallbackException e) {
         Console.WriteLine(e.ToString());
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//    Decoding with error detection:
//    System.Text.DecoderFallbackException: Unable to translate bytes [FF][D8][FF][01] at index
//    20 from specified code page to Unicode.
//       at System.Text.DecoderExceptionFallbackBuffer.Throw(Byte[] bytesUnknown, Int32 index)
//       at System.Text.DecoderExceptionFallbackBuffer.Fallback(Byte[] bytesUnknown, Int32 index
//    )
//       at System.Text.DecoderFallbackBuffer.InternalFallback(Byte[] bytes, Byte* pBytes)
//       at System.Text.UTF32Encoding.GetCharCount(Byte* bytes, Int32 count, DecoderNLS baseDeco
//    der)
//       at System.Text.UTF32Encoding.GetString(Byte[] bytes, Int32 index, Int32 count)
//       at Example.PrintDecodedString(Byte[] bytes, Encoding enc)
//
//    Decoding without error detection:
//       Decoded string: zăǽβ�
Imports System.Text

Public Module Example
   Public Sub Main()
      ' Create a UTF32Encoding object with error detection enabled.
      Dim encExc As New UTF32Encoding(Not BitConverter.IsLittleEndian, True, True)
      ' Create a UTF32Encoding object with error detection disabled.
      Dim encRepl As New UTF32Encoding(Not BitConverter.IsLittleEndian, True, False)

      ' Create a byte arrays from a string, and add an invalid surrogate pair, as follows.
      '    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)
      '    an invalid low surrogate (U+01FF)
      Dim s As String = "za" & ChrW(&H0306) & ChrW(&H01FD) & ChrW(&H03B2)

      ' Encode the string using little-endian byte order.
      Dim index As Integer = encExc.GetBytecount(s)
      Dim bytes(index + 3) As Byte
      encExc.GetBytes(s, 0, s.Length, bytes, 0)
      bytes(index) = &hFF
      bytes(index + 1) = &hD8
      bytes(index + 2) = &hFF
      bytes(index + 3) = &h01

      ' Decode the byte array with error detection.
      Console.WriteLine("Decoding with error detection:")
      PrintDecodedString(bytes, encExc)

      ' Decode the byte array without error detection.
      Console.WriteLine("Decoding without error detection:")
      PrintDecodedString(bytes, encRepl)
   End Sub

   ' Decode the bytes and display the string.
   Public Sub PrintDecodedString(bytes() As Byte, enc As Encoding)
      Try
         Console.WriteLine("   Decoded string: {0}", enc.GetString(bytes, 0, bytes.Length))
      Catch e As DecoderFallbackException
         Console.WriteLine(e.ToString())
      End Try
      Console.WriteLine()
   End Sub
End Module
' The example displays the following output:
'    Decoding with error detection:
'    System.Text.DecoderFallbackException: Unable to translate bytes [FF][D8][FF][01] at index
'    20 from specified code page to Unicode.
'       at System.Text.DecoderExceptionFallbackBuffer.Throw(Byte[] bytesUnknown, Int32 index)
'       at System.Text.DecoderExceptionFallbackBuffer.Fallback(Byte[] bytesUnknown, Int32 index
'    )
'       at System.Text.DecoderFallbackBuffer.InternalFallback(Byte[] bytes, Byte* pBytes)
'       at System.Text.UTF32Encoding.GetCharCount(Byte* bytes, Int32 count, DecoderNLS baseDeco
'    der)
'       at System.Text.UTF32Encoding.GetString(Byte[] bytes, Int32 index, Int32 count)
'       at Example.PrintDecodedString(Byte[] bytes, Encoding enc)
'
'    Decoding without error detection:
'       Decoded string: zăǽβ�

Následující příklad kóduje řetězec znaků Unicode do pole bajtů pomocí objektu UTF32Encoding . Pole bajtů je pak dekódováno do řetězce, který demonstruje, že nedojde ke ztrátě dat.

using System;
using System.Text;

public class Example
{
    public static void Main()
    {
        // The encoding.
        var enc = new UTF32Encoding();
        
        // Create a string.
        String s = "This string contains two characters " +
                   "with codes outside the ASCII code range: " +
                   "Pi (\u03A0) and Sigma (\u03A3).";
        Console.WriteLine("Original string:");
        Console.WriteLine("   {0}", s);
        
        // Encode the string.
        Byte[] encodedBytes = enc.GetBytes(s);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        for (int ctr = 0; ctr < encodedBytes.Length; ctr++) {
            Console.Write("[{0:X2}]{1}", encodedBytes[ctr],
                                         (ctr + 1) % 4 == 0 ? " " : "" );
            if ((ctr + 1) % 16 == 0) Console.WriteLine();
        }
        Console.WriteLine();
        
        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = enc.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded string:");
        Console.WriteLine("   {0}", decodedString);
    }
}
// The example displays the following output:
//    Original string:
//       This string contains two characters with codes outside the ASCII code range:
//    Pi (π) and Sigma (Σ).
//
//    Encoded bytes:
//    [54][00][00][00] [68][00][00][00] [69][00][00][00] [73][00][00][00]
//    [20][00][00][00] [73][00][00][00] [74][00][00][00] [72][00][00][00]
//    [69][00][00][00] [6E][00][00][00] [67][00][00][00] [20][00][00][00]
//    [63][00][00][00] [6F][00][00][00] [6E][00][00][00] [74][00][00][00]
//    [61][00][00][00] [69][00][00][00] [6E][00][00][00] [73][00][00][00]
//    [20][00][00][00] [74][00][00][00] [77][00][00][00] [6F][00][00][00]
//    [20][00][00][00] [63][00][00][00] [68][00][00][00] [61][00][00][00]
//    [72][00][00][00] [61][00][00][00] [63][00][00][00] [74][00][00][00]
//    [65][00][00][00] [72][00][00][00] [73][00][00][00] [20][00][00][00]
//    [77][00][00][00] [69][00][00][00] [74][00][00][00] [68][00][00][00]
//    [20][00][00][00] [63][00][00][00] [6F][00][00][00] [64][00][00][00]
//    [65][00][00][00] [73][00][00][00] [20][00][00][00] [6F][00][00][00]
//    [75][00][00][00] [74][00][00][00] [73][00][00][00] [69][00][00][00]
//    [64][00][00][00] [65][00][00][00] [20][00][00][00] [74][00][00][00]
//    [68][00][00][00] [65][00][00][00] [20][00][00][00] [41][00][00][00]
//    [53][00][00][00] [43][00][00][00] [49][00][00][00] [49][00][00][00]
//    [20][00][00][00] [63][00][00][00] [6F][00][00][00] [64][00][00][00]
//    [65][00][00][00] [20][00][00][00] [72][00][00][00] [61][00][00][00]
//    [6E][00][00][00] [67][00][00][00] [65][00][00][00] [3A][00][00][00]
//    [20][00][00][00] [50][00][00][00] [69][00][00][00] [20][00][00][00]
//    [28][00][00][00] [A0][03][00][00] [29][00][00][00] [20][00][00][00]
//    [61][00][00][00] [6E][00][00][00] [64][00][00][00] [20][00][00][00]
//    [53][00][00][00] [69][00][00][00] [67][00][00][00] [6D][00][00][00]
//    [61][00][00][00] [20][00][00][00] [28][00][00][00] [A3][03][00][00]
//    [29][00][00][00] [2E][00][00][00]
//
//    Decoded string:
//       This string contains two characters with codes outside the ASCII code range:
//    Pi (π) and Sigma (Σ).
Imports System.Text

Class Example
    Public Shared Sub Main()
        ' The encoding.
        Dim enc As New UTF32Encoding()
        
        ' Create a string.
        Dim s As String =
            "This string contains two characters " &
            "with codes outside the ASCII code range: " &
            "Pi (" & ChrW(&h03A0) & ") and Sigma (" & ChrW(&h03A3) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine("   {0}", s)
        
        ' Encode the string.
        Dim encodedBytes As Byte() = enc.GetBytes(s)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        For ctr As Integer = 0 To encodedBytes.Length - 1
            Console.Write("[{0:X2}]{1}", encodedBytes(ctr),
                                         If((ctr + 1) Mod 4 = 0, " ", "" ))
            If (ctr + 1) Mod 16 = 0 Then Console.WriteLine()
        Next
        Console.WriteLine()
        
        ' Decode bytes back to string.
        ' Notice Pi and Sigma characters are still present.
        Dim decodedString As String = enc.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded string:")
        Console.WriteLine("   {0}", decodedString)
    End Sub
End Class
' The example displays the following output:
'    Original string:
'       This string contains two characters with codes outside the ASCII code range:
'    Pi (π) and Sigma (Σ).
'
'    Encoded bytes:
'    [54][00][00][00] [68][00][00][00] [69][00][00][00] [73][00][00][00]
'    [20][00][00][00] [73][00][00][00] [74][00][00][00] [72][00][00][00]
'    [69][00][00][00] [6E][00][00][00] [67][00][00][00] [20][00][00][00]
'    [63][00][00][00] [6F][00][00][00] [6E][00][00][00] [74][00][00][00]
'    [61][00][00][00] [69][00][00][00] [6E][00][00][00] [73][00][00][00]
'    [20][00][00][00] [74][00][00][00] [77][00][00][00] [6F][00][00][00]
'    [20][00][00][00] [63][00][00][00] [68][00][00][00] [61][00][00][00]
'    [72][00][00][00] [61][00][00][00] [63][00][00][00] [74][00][00][00]
'    [65][00][00][00] [72][00][00][00] [73][00][00][00] [20][00][00][00]
'    [77][00][00][00] [69][00][00][00] [74][00][00][00] [68][00][00][00]
'    [20][00][00][00] [63][00][00][00] [6F][00][00][00] [64][00][00][00]
'    [65][00][00][00] [73][00][00][00] [20][00][00][00] [6F][00][00][00]
'    [75][00][00][00] [74][00][00][00] [73][00][00][00] [69][00][00][00]
'    [64][00][00][00] [65][00][00][00] [20][00][00][00] [74][00][00][00]
'    [68][00][00][00] [65][00][00][00] [20][00][00][00] [41][00][00][00]
'    [53][00][00][00] [43][00][00][00] [49][00][00][00] [49][00][00][00]
'    [20][00][00][00] [63][00][00][00] [6F][00][00][00] [64][00][00][00]
'    [65][00][00][00] [20][00][00][00] [72][00][00][00] [61][00][00][00]
'    [6E][00][00][00] [67][00][00][00] [65][00][00][00] [3A][00][00][00]
'    [20][00][00][00] [50][00][00][00] [69][00][00][00] [20][00][00][00]
'    [28][00][00][00] [A0][03][00][00] [29][00][00][00] [20][00][00][00]
'    [61][00][00][00] [6E][00][00][00] [64][00][00][00] [20][00][00][00]
'    [53][00][00][00] [69][00][00][00] [67][00][00][00] [6D][00][00][00]
'    [61][00][00][00] [20][00][00][00] [28][00][00][00] [A3][03][00][00]
'    [29][00][00][00] [2E][00][00][00]
'
'    Decoded string:
'       This string contains two characters with codes outside the ASCII code range:
'    Pi (π) and Sigma (Σ).

Následující příklad používá stejný řetězec jako předchozí s tím rozdílem, že zapíše kódované bajty do souboru a před datový proud bajtů předponu značka pořadí bajtů (BOM). Pak soubor načte dvěma různými způsoby: jako textový soubor pomocí objektu StreamReader a jako binární soubor. Jak byste očekávali, ani nově přečtený řetězec neobsahuje kusovník.

using System;
using System.IO;
using System.Text;

public class Example
{
    public static void Main()
    {
        // Create a UTF-32 encoding that supports a BOM.
        var enc = new UTF32Encoding();
        
        // A Unicode string with two characters outside an 8-bit code range.
        String s = "This Unicode string has 2 characters " +
                   "outside the ASCII range: \n" +
                   "Pi (\u03A0), and Sigma (\u03A3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(s);
        Console.WriteLine();
        
        // Encode the string.
        Byte[] encodedBytes = enc.GetBytes(s);
        Console.WriteLine("The encoded string has {0} bytes.\n",
                          encodedBytes.Length);

        // Write the bytes to a file with a BOM.
        var fs = new FileStream(@".\UTF32Encoding.txt", FileMode.Create);
        Byte[] bom = enc.GetPreamble();
        fs.Write(bom, 0, bom.Length);
        fs.Write(encodedBytes, 0, encodedBytes.Length);
        Console.WriteLine("Wrote {0} bytes to the file.\n", fs.Length);
        fs.Close();

        // Open the file using StreamReader.
        var sr = new StreamReader(@".\UTF32Encoding.txt");
        String newString = sr.ReadToEnd();
        sr.Close();
        Console.WriteLine("String read using StreamReader:");
        Console.WriteLine(newString);
        Console.WriteLine();
        
        // Open the file as a binary file and decode the bytes back to a string.
        fs = new FileStream(@".\Utf32Encoding.txt", FileMode.Open);
        Byte[] bytes = new Byte[fs.Length];
        fs.Read(bytes, 0, (int)fs.Length);
        fs.Close();

        String decodedString = enc.GetString(bytes);
        Console.WriteLine("Decoded bytes from binary file:");
        Console.WriteLine(decodedString);
    }
}
// The example displays the following output:
//    Original string:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    The encoded string has 340 bytes.
//
//    Wrote 344 bytes to the file.
//
//    String read using StreamReader:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    Decoded bytes from binary file:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
Imports System.IO
Imports System.Text

Class Example
    Public Shared Sub Main()
        ' Create a UTF-32 encoding that supports a BOM.
        Dim enc As New UTF32Encoding()
        
        ' A Unicode string with two characters outside an 8-bit code range.
        Dim s As String = _
            "This Unicode string has 2 characters outside the " &
            "ASCII range: " & vbCrLf &
            "Pi (" & ChrW(&h03A0) & "), and Sigma (" & ChrW(&h03A3) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(s)
        Console.WriteLine()
        
        ' Encode the string.
        Dim encodedBytes As Byte() = enc.GetBytes(s)
        Console.WriteLine("The encoded string has {0} bytes.",
                          encodedBytes.Length)
        Console.WriteLine()
        
        ' Write the bytes to a file with a BOM.
        Dim fs As New FileStream(".\UTF32Encoding.txt", FileMode.Create)
        Dim bom() As Byte = enc.GetPreamble()
        fs.Write(bom, 0, bom.Length)
        fs.Write(encodedBytes, 0, encodedBytes.Length)
        Console.WriteLine("Wrote {0} bytes to the file.", fs.Length)
        fs.Close()
        Console.WriteLine()
        
        ' Open the file using StreamReader.
        Dim sr As New StreamReader(".\UTF32Encoding.txt")
        Dim newString As String = sr.ReadToEnd()
        sr.Close()
        Console.WriteLine("String read using StreamReader:")
        Console.WriteLine(newString)
        Console.WriteLine()
        
        ' Open the file as a binary file and decode the bytes back to a string.
        fs = new FileStream(".\Utf32Encoding.txt", FileMode.Open)
        Dim bytes(fs.Length - 1) As Byte
        fs.Read(bytes, 0, fs.Length)
        fs.Close()

        Dim decodedString As String = enc.GetString(bytes)
        Console.WriteLine("Decoded bytes from binary file:")
        Console.WriteLine(decodedString)
    End Sub
End Class
' The example displays the following output:
'    Original string:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).
'
'    The encoded string has 344 bytes.
'
'    Wrote 348 bytes to the file.
'
'    String read using StreamReader:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).
'
'    Decoded bytes from binary file:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).

Poznámky

Kódování je proces transformace sady znaků Unicode na sekvenci bajtů. Dekódování je proces transformace posloupnosti zakódovaných bajtů na sadu znaků Unicode.

Standard Unicode přiřadí každému znaku v každém podporovaném skriptu bod kódu (číslo). Formát UTF (Unicode Transformation Format) je způsob, jak tento bod kódu zakódovat. Standard Unicode používá následující utFs:

  • UTF-8, který představuje každý bod kódu jako sekvenci jednoho až čtyř bajtů.

  • UTF-16, který představuje každý bod kódu jako posloupnost jednoho až dvou 16bitových celých čísel.

  • UTF-32, který představuje každý bod kódu jako 32bitové celé číslo.

Další informace o UTF a dalších kódováních podporovaných nástrojem System.Textnajdete v tématu Kódování znaků v .NET.

Třída UTF32Encoding představuje kódování UTF-32. Kodér může použít pořadí bajtů big endian (nejdůležitější bajt nejprve) nebo malé pořadí bajtů endian (nejméně významný bajt první). Například velké písmeno latinky A (bod kódu U+0041) je serializováno následujícím způsobem (v šestnáctkové soustavě):

  • Pořadí bajtů Big endian: 00 00 00 41

  • Malé endian pořadí bajtů: 41 00 00 00

Obecně je efektivnější ukládat znaky Unicode pomocí nativního pořadí bajtů. Například je lepší použít malé pořadí bajtů endian na malých endian platformách, jako jsou počítače Intel. UTF32Encoding odpovídá znakové stránce Windows 12000 (malé pořadí bajtů endian) a 12001 (velké pořadí bajtů endian). Můžete určit "endianness" konkrétní architektury voláním BitConverter.IsLittleEndian metody.

UTF32Encoding Volitelně objekt poskytuje značku pořadí bajtů (BOM), což je pole bajtů, které může být předponou posloupnosti bajtů vyplývajících z procesu kódování. Pokud preambule obsahuje značku pořadí bajtů, pomůže dekodéru určit pořadí bajtů a formát transformace nebo UTF pole bajtů.

UTF32Encoding Pokud je instance nakonfigurovaná tak, aby poskytovala kusovník, můžete ji načíst voláním GetPreamble metody. V opačném případě metoda vrátí prázdné pole. Všimněte si, že i když UTF32Encoding je objekt nakonfigurovaný pro podporu kusovníku, musíte na začátek zakódovaného datového UTF32Encoding proudu bajtů podle potřeby zahrnout kusovník. Metody kódování třídy to automaticky neudělají.

Upozornění

Pokud chcete povolit detekci chyb a lépe zabezpečit instanci třídy, měli byste vytvořit instanci objektu UTF32Encoding voláním konstruktoru UTF32Encoding(Boolean, Boolean, Boolean) a nastavením jeho throwOnInvalidBytes argumentu na truehodnotu . Při detekci chyb vyvolá metoda, která detekuje neplatnou posloupnost znaků nebo bajtů výjimku ArgumentException . Bez detekce chyb nedojde k žádné výjimce a neplatná sekvence se obecně ignoruje.

Vytvořit instanci objektu UTF32Encoding můžete mnoha způsoby v závislosti na tom, jestli chcete zadat značku pořadí bajtů (BOM), jestli chcete kódování big-endian nebo little-endian a jestli chcete povolit detekci chyb. Následující tabulka obsahuje seznam UTF32Encoding konstruktorů a Encoding vlastností, které vrací UnicodeEncoding objekt.

Člen Endianness KUSOVNÍKU Detekce chyb
Encoding.UTF32 Malý endian Yes Ne (náhradní náhradní)
UTF32Encoding.UTF32Encoding() Malý endian Yes Ne (náhradní náhradní)
UTF32Encoding.UTF32Encoding(Boolean, Boolean) Konfigurovatelné Konfigurovatelné Ne (náhradní náhradní)
UTF32Encoding.UTF32Encoding(Boolean, Boolean, Boolean) Konfigurovatelné Konfigurovatelné Konfigurovatelné

Metoda GetByteCount určuje, kolik bajtů má za následek kódování sady znaků Unicode, a GetBytes metoda provede skutečné kódování.

Stejně tak metoda určuje, GetCharCount kolik znaků má za následek dekódování posloupnosti bajtů a GetChars metody a GetString provádějí vlastní dekódování.

Pro kodér nebo dekodér, který je schopen ukládat informace o stavu při kódování nebo dekódování dat, která pokrývají více bloků (například řetězec o 1 milionu znaků, který je zakódován ve 100 000 znakových segmentech), použijte GetEncoder vlastnosti a GetDecoder v uvedeném pořadí.

Konstruktory

UTF32Encoding()

Inicializuje novou instanci UTF32Encoding třídy .

UTF32Encoding(Boolean, Boolean)

Inicializuje novou instanci UTF32Encoding třídy . Parametry určují, jestli se má použít pořadí bajtů big endian a jestli GetPreamble() metoda vrátí značku pořadí bajtů Unicode.

UTF32Encoding(Boolean, Boolean, Boolean)

Inicializuje novou instanci UTF32Encoding třídy . Parametry určují, jestli se má použít pořadí bajtů big endian, jestli se má zadat značka pořadí bajtů Unicode a jestli se má při zjištění neplatného kódování vyvolat výjimka.

Vlastnosti

BodyName

Při přepsání v odvozené třídě získá název pro aktuální kódování, které lze použít se značkami textu poštovního agenta.

(Zděděno od Encoding)
CodePage

Při přepsání v odvozené třídě získá identifikátor znakové stránky aktuálního Encoding.

(Zděděno od Encoding)
DecoderFallback

Získá nebo nastaví DecoderFallback objekt pro aktuální Encoding objekt.

(Zděděno od Encoding)
EncoderFallback

Získá nebo nastaví EncoderFallback objekt pro aktuální Encoding objekt.

(Zděděno od Encoding)
EncodingName

Při přepsání v odvozené třídě získá popis aktuálního kódování čitelný pro člověka.

(Zděděno od Encoding)
HeaderName

Při přepsání v odvozené třídě získá název pro aktuální kódování, které lze použít se značkami hlavičky poštovního agenta.

(Zděděno od Encoding)
IsBrowserDisplay

Při přepsání v odvozené třídě získá hodnotu označující, zda aktuální kódování mohou použít klienti prohlížeče pro zobrazení obsahu.

(Zděděno od Encoding)
IsBrowserSave

Při přepsání v odvozené třídě získá hodnotu označující, zda aktuální kódování mohou použít klienti prohlížeče pro ukládání obsahu.

(Zděděno od Encoding)
IsMailNewsDisplay

Při přepsání v odvozené třídě získá hodnotu označující, zda aktuální kódování lze použít poštovní a zpravodajské klienty pro zobrazení obsahu.

(Zděděno od Encoding)
IsMailNewsSave

Při přepsání v odvozené třídě získá hodnotu označující, zda aktuální kódování lze použít poštovní a zpravodajské klienty pro ukládání obsahu.

(Zděděno od Encoding)
IsReadOnly

Při přepsání v odvozené třídě získá hodnotu označující, zda je aktuální kódování jen pro čtení.

(Zděděno od Encoding)
IsSingleByte

Při přepsání v odvozené třídě získá hodnotu označující, zda aktuální kódování používá jedno bajtové body kódu.

(Zděděno od Encoding)
Preamble

Získá Unicode pořadí bajtů značky kódované ve formátu UTF-32, pokud je tento objekt nakonfigurován tak, aby jeden.

Preamble

Při přepsání v odvozené třídě vrátí span obsahující sekvenci bajtů, která určuje použité kódování.

(Zděděno od Encoding)
WebName

Při přepsání v odvozené třídě získá název zaregistrovaný u IANA (Internet Assigned Numbers Authority) pro aktuální kódování.

(Zděděno od Encoding)
WindowsCodePage

Při přepsání v odvozené třídě získá znakovou stránku operačního systému Windows, která nejvíce odpovídá aktuálnímu kódování.

(Zděděno od Encoding)

Metody

Clone()

Při přepsání v odvozené třídě vytvoří mělkou kopii aktuálního Encoding objektu.

(Zděděno od Encoding)
Equals(Object)

Určuje, zda se zadaná Object hodnota rovná aktuálnímu UTF32Encoding objektu.

GetByteCount(Char*, Int32)

Vypočítá počet bajtů vytvořených kódováním sady znaků počínaje zadaným znakovým ukazatelem.

GetByteCount(Char[])

Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním všech znaků v zadaném poli znaků.

(Zděděno od Encoding)
GetByteCount(Char[], Int32, Int32)

Vypočítá počet bajtů vytvořených kódováním sady znaků ze zadaného pole znaků.

GetByteCount(ReadOnlySpan<Char>)

Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním znaků v zadaném rozsahu znaků.

(Zděděno od Encoding)
GetByteCount(String)

Vypočítá počet bajtů vytvořených kódováním znaků v zadaném Stringznaku .

GetByteCount(String, Int32, Int32)

Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním sady znaků ze zadaného řetězce.

(Zděděno od Encoding)
GetBytes(Char*, Int32, Byte*, Int32)

Zakóduje sadu znaků začínajících na zadaném znakovém ukazateli do posloupnosti bajtů, které jsou uloženy od zadaného ukazatele bajtů.

GetBytes(Char[])

Při přepsání v odvozené třídě zakóduje všechny znaky v zadaném poli znaků do posloupnosti bajtů.

(Zděděno od Encoding)
GetBytes(Char[], Int32, Int32)

Při přepsání v odvozené třídě zakóduje sadu znaků ze zadaného pole znaků do posloupnosti bajtů.

(Zděděno od Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)

Zakóduje sadu znaků ze zadaného pole znaků do zadaného pole bajtů.

GetBytes(ReadOnlySpan<Char>, Span<Byte>)

Při přepsání v odvozené třídě zakóduje do rozsahu bajtů sadu znaků ze zadaného rozsahu jen pro čtení.

(Zděděno od Encoding)
GetBytes(String)

Při přepsání v odvozené třídě zakóduje všechny znaky v zadaném řetězci do posloupnosti bajtů.

(Zděděno od Encoding)
GetBytes(String, Int32, Int32)

Při přepsání v odvozené třídě kóduje do pole bajtů počet znaků zadaný v zadaném řetězci, počínaje zadaným indexřetězcem count .

(Zděděno od Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)

Zakóduje sadu znaků ze zadaného String pole do zadaného pole bajtů.

GetCharCount(Byte*, Int32)

Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů počínaje zadaným bajtovým ukazatelem.

GetCharCount(Byte[])

Při přepsání v odvozené třídě vypočítá počet znaků vytvořených dekódováním všech bajtů v zadaném bajtovém poli.

(Zděděno od Encoding)
GetCharCount(Byte[], Int32, Int32)

Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů ze zadaného pole bajtů.

GetCharCount(ReadOnlySpan<Byte>)

Při přepsání v odvozené třídě vypočítá počet znaků vytvořených dekódováním zadaného rozsahu bajtů jen pro čtení.

(Zděděno od Encoding)
GetChars(Byte*, Int32, Char*, Int32)

Dekóduje posloupnost bajtů začínající od zadaného ukazatele bajtů do sady znaků, které jsou uloženy od zadaného znakového ukazatele.

GetChars(Byte[])

Při přepsání v odvozené třídě dekóduje všechny bajty v zadaném poli bajtů do sady znaků.

(Zděděno od Encoding)
GetChars(Byte[], Int32, Int32)

Při přepsání v odvozené třídě dekóduje sekvenci bajtů ze zadaného pole bajtů do sady znaků.

(Zděděno od Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)

Dekóduje posloupnost bajtů ze zadaného pole bajtů do zadaného pole znaků.

GetChars(ReadOnlySpan<Byte>, Span<Char>)

Při přepsání v odvozené třídě dekóduje všechny bajty v zadaném rozsahu bajtů jen pro čtení do rozsahu znaků.

(Zděděno od Encoding)
GetDecoder()

Získá dekodér, který převede posloupnost bajtů kódování UTF-32 na sekvenci znaků Unicode.

GetEncoder()

Získá kodér, který převádí sekvenci znaků Unicode na posloupnost bajtů kódování UTF-32.

GetHashCode()

Vrátí kód hash pro aktuální instanci.

GetMaxByteCount(Int32)

Vypočítá maximální počet bajtů vytvořených kódováním zadaného počtu znaků.

GetMaxCharCount(Int32)

Vypočítá maximální počet znaků vytvořených dekódováním zadaného počtu bajtů.

GetPreamble()

Vrátí značku pořadí bajtů Unicode kódovanou ve formátu UTF-32, pokud UTF32Encoding je objekt nakonfigurován tak, aby ji dodá.

GetString(Byte*, Int32)

Při přepsání v odvozené třídě dekóduje zadaný počet bajtů začínající na zadané adrese do řetězce.

(Zděděno od Encoding)
GetString(Byte[])

Při přepsání v odvozené třídě dekóduje všechny bajty v zadaném poli bajtů do řetězce.

(Zděděno od Encoding)
GetString(Byte[], Int32, Int32)

Dekóduje rozsah bajtů z pole bajtů do řetězce.

GetString(ReadOnlySpan<Byte>)

Při přepsání v odvozené třídě dekóduje všechny bajty v zadaném rozsahu bajtů do řetězce.

(Zděděno od Encoding)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
IsAlwaysNormalized()

Získá hodnotu označující, zda je aktuální kódování vždy normalizován pomocí výchozího formuláře normalizace.

(Zděděno od Encoding)
IsAlwaysNormalized(NormalizationForm)

Při přepsání v odvozené třídě získá hodnotu označující, zda je aktuální kódování vždy normalizován pomocí zadané normalizační formy.

(Zděděno od Encoding)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)

Kóduje do rozsahu bajtů sadu znaků ze zadaného rozsahu jen pro čtení, pokud je cíl dostatečně velký.

(Zděděno od Encoding)
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)

Dekóduje do rozsahu znaků sadu bajtů ze zadaného rozsahu jen pro čtení, pokud je cíl dostatečně velký.

(Zděděno od Encoding)

Metody rozšíření

GetBytes(Encoding, ReadOnlySequence<Char>)

Zakóduje zadaný ReadOnlySequence<T>Byte do pole pomocí zadaného Encoding.

GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)

Dekóduje zadaný ReadOnlySequence<T> parametr na bytes pomocí zadaného Encoding a zapíše výsledek do writer.

GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)

Zakóduje zadané ReadOnlySequence<T> do s bytepomocí zadané Encoding hodnoty a výsledek vypíše do bytes.

GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)

Zakóduje zadané ReadOnlySpan<T> do s bytepomocí zadaného Encoding a zapíše výsledek do writer.

GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)

Dekóduje zadaný ReadOnlySequence<T> parametr na chars pomocí zadaného Encoding a zapíše výsledek do writer.

GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)

Dekóduje zadaný ReadOnlySequence<T> parametr na chars pomocí zadané Encoding hodnoty a výsledek se vypíše do chars.

GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)

Dekóduje zadaný ReadOnlySpan<T> parametr na chars pomocí zadaného Encoding a zapíše výsledek do writer.

GetString(Encoding, ReadOnlySequence<Byte>)

Dekóduje zadaný ReadOnlySequence<T> parametr na pomocí String zadaného Encoding.

Platí pro

Viz také