UTF32Encoding Třída

Definice

Obor názvů:: System.Text

Sestavení:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Sestavení:: netstandard.dll, System.Text.Encoding.Extensions.dll

Sestavení:: System.Text.Encoding.Extensions.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Zdroj:: UTF32Encoding.cs

Zdroj:: UTF32Encoding.cs

Zdroj:: UTF32Encoding.cs

Zdroj:: UTF32Encoding.cs

Zdroj:: UTF32Encoding.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: Object

Encoding
UTF32Encoding

Atributy: SerializableAttribute

Příklady

Následující příklad ukazuje chování UTF32Encoding objektů s povolenou detekcí chyb a bez povolení detekce chyb. Vytvoří bajtové pole, jehož poslední čtyři bajty představují neplatný náhradní pár; za vysokou náhradou U+D8FF následuje U+01FF, který je mimo rozsah nízkých náhradních dotazů (0xDC00 až 0xDFFF). Bez detekce chyb dekodér UTF32 používá náhradní náhradní náhradní dvojici nahrazení znakem REPLACE CHARACTER (U+FFFD).

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: zăǽβ�

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: zăǽβ�

Následující příklad zakóduje řetězec znaků Unicode do bajtového pole pomocí objektu UTF32Encoding . Bajtové pole se pak dekóduje do řetězce, aby ukázalo, ž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ředpony datového proudu bajtů se značkou pořadí bajtů (BOM). Pak soubor č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 posloupnost bajtů. Dekódování je proces transformace sekvence kó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 transformace Unicode (UTF) je způsob kódování tohoto bodu kódu. Standard Unicode používá následující UTF:

UTF-8, který představuje každý bod kódu jako posloupnost 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 System.Textv .NET naleznete v tématu Kódování znaků.

Třída UTF32Encoding představuje kódování UTF-32. Kodér může použít velké pořadí bajtů endianu (nejvýznamnější bajt první) nebo malé endian bajtové pořadí (nejméně významné bajty první). Například velké písmeno latinky A (bod kódu U+0041) se serializuje takto (v šestnáctkovém formátu):

Velké endian bajt pořadí: 00 00 00 41
Malé endian bajt pořadí: 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é endian bajtové pořadí na malých endian platformách, jako jsou počítače Intel. UTF32Encoding odpovídá stránkám kódu Systému Windows 12000 (pořadí malých bajtů endian) a 12001 (pořadí velkých bajtů). "Endianness" konkrétní architektury můžete určit voláním BitConverter.IsLittleEndian metody.

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

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ázdnou matici. Mějte na paměti, že i když UTF32Encoding je objekt nakonfigurovaný pro podporu kusovníku, musíte uvést kusovník na začátku zakódovaného bajtového datového proudu podle potřeby; metody UTF32Encoding kódování třídy to neprodělají automaticky.

Upozornění

Chcete-li povolit detekci chyb a zajistit vyšší zabezpečení instance třídy, měli byste vytvořit instanci UTF32Encoding objektu voláním konstruktoru UTF32Encoding(Boolean, Boolean, Boolean) a nastavením jeho throwOnInvalidBytes argumentu na true. Při detekci chyb vyvolá metoda, která detekuje neplatnou sekvenci znaků nebo bajtů ArgumentException výjimku. Bez detekce chyb se nevyvolá žádná výjimka a neplatná sekvence se obecně ignoruje.

Objekt můžete UTF32Encoding vytvořit několika způsoby, a to v závislosti na tom, jestli chcete zadat značku pořadí bajtů (BOM), jestli chcete kódování typu big-endian nebo little-endian a jestli chcete povolit detekci chyb. Následující tabulka uvádí UTF32Encoding konstruktory a Encoding vlastnosti, které vrací UnicodeEncoding objekt.

Člen	Endiánství	KUSOVNÍK	Detekce chyb
Encoding.UTF32	Little-endian	Ano	Ne (náhradní náhradní)
UTF32Encoding.UTF32Encoding()	Little-endian	Ano	Ne (náhradní náhradní)
UTF32Encoding.UTF32Encoding(Boolean, Boolean)	Configurable	Configurable	Ne (náhradní náhradní)
UTF32Encoding.UTF32Encoding(Boolean, Boolean, Boolean)	Configurable	Configurable	Configurable

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

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

Pro kodér nebo dekodér, který je schopen uložit informace o stavu při kódování nebo dekódování dat, která pokrývají více bloků (například řetězec 1 milion znaků kódovaný v 100 000 segmentech znaků), použijte vlastnosti GetEncoder a GetDecoder vlastnosti.

Konstruktory

Name	Description
UTF32Encoding()	Inicializuje novou instanci UTF32Encoding třídy.
UTF32Encoding(Boolean, Boolean, Boolean)	Inicializuje novou instanci UTF32Encoding třídy. Parametry určují, jestli se má použít pořadí velkých bajtů endianu, zda má být zadán znak pořadí bajtů Unicode a zda má být vyvolána výjimka při zjištění neplatného kódování.
UTF32Encoding(Boolean, Boolean)	Inicializuje novou instanci UTF32Encoding třídy. Parametry určují, zda se má použít pořadí velkých bajtů endian a zda GetPreamble() metoda vrací znak pořadí bajtů Unicode.

Vlastnosti

Name	Description
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 agenta pošty. (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á human-readable popis aktuální kódování. (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 agenta pošty. (Zděděno od Encoding)
IsBrowserDisplay	Při přepsání v odvozené třídě získá hodnotu určující, zda aktuální kódování může být použito klienty prohlížeče pro zobrazení obsahu. (Zděděno od Encoding)
IsBrowserSave	Při přepsání v odvozené třídě získá hodnotu určující, zda aktuální kódování lze použít klienty 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í může být používáno klienty pošty a zpráv 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í může být používáno poštovními a informačními klienty k ukládání obsahu. (Zděděno od Encoding)
IsReadOnly	Při přepsání v odvozené třídě získá hodnotu určující, zda aktuální kódování je 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á jednobajtů kódové body. (Zděděno od Encoding)
Preamble	Získá znak pořadí bajtů Unicode 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í rozsah obsahující posloupnost 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ý v 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

Name	Description
Clone()	Při přepsání v odvozené třídě vytvoří mělké kopie aktuálního Encoding objektu. (Zděděno od Encoding)
Equals(Object)	Určuje, zda je zadaná Object hodnota rovna aktuálnímu UTF32Encoding objektu.
GetByteCount(Char[], Int32, Int32)	Vypočítá počet bajtů vytvořených kódováním sady znaků ze zadaného pole znaků.
GetByteCount(Char[])	Při přepsání v odvozené třídě vypočítá počet bajtů vytvořených kódováním všech znaků v zadaném poli znaků. (Zděděno od Encoding)
GetByteCount(Char*, Int32)	Vypočítá počet bajtů vytvořených kódováním sady znaků začínající zadaným ukazatelem znaku.
GetByteCount(ReadOnlySpan<Char>)	Při přepsání v odvozené třídě vypočítá počet bajtů vytvořených kódováním znaků v zadaném rozsahu znaků. (Zděděno od Encoding)
GetByteCount(String, Int32, Int32)	Při přepsání v odvozené třídě vypočítá počet bajtů vytvořených kódováním sady znaků ze zadaného řetězce. (Zděděno od Encoding)
GetByteCount(String)	Vypočítá počet bajtů vytvořených kódováním znaků v zadaném Stringargumentu .
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Zakóduje sadu znaků ze zadaného pole znaků do zadaného bajtového pole.
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[])	Při přepsání v odvozené třídě zakóduje všechny znaky v zadaném znakovém poli do posloupnosti bajtů. (Zděděno od Encoding)
GetBytes(Char, Int32, Byte, Int32)	Zakóduje sadu znaků začínající zadaným ukazatelem znaků do posloupnosti bajtů, které jsou uloženy od zadaného bajtového ukazatele.
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, Int32, Int32, Byte[], Int32)	Zakóduje sadu znaků ze zadaného String pole bajtů.
GetBytes(String, Int32, Int32)	Při přepsání v odvozené třídě kóduje do pole bajtů počet znaků zadaný `count` v zadaném řetězci počínaje zadaným `index`řetězcem . (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)
GetCharCount(Byte[], Int32, Int32)	Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů ze zadaného bajtového pole.
GetCharCount(Byte[])	Při přepsání v odvozené třídě vypočítá počet znaků vytvořený dekódováním všech bajtů v zadané bajtové matici. (Zděděno od Encoding)
GetCharCount(Byte*, Int32)	Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů počínaje zadaným ukazatelem bajtu.
GetCharCount(ReadOnlySpan<Byte>)	Při přepsání v odvozené třídě vypočítá počet znaků vytvořených dekódováním poskytnutého bajtu jen pro čtení. (Zděděno od Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Dekóduje posloupnost bajtů ze zadaného bajtového pole do zadaného znakového pole.
GetChars(Byte[], Int32, Int32)	Při přepsání v odvozené třídě dekóduje posloupnost bajtů ze zadaného bajtového pole do sady znaků. (Zděděno od Encoding)
GetChars(Byte[])	Při přepsání v odvozené třídě dekóduje všechny bajty v zadané bajtové matici do sady znaků. (Zděděno od Encoding)
GetChars(Byte, Int32, Char, Int32)	Dekóduje posloupnost bajtů počínaje zadaným bajtovým ukazatelem na sadu znaků, které jsou uloženy od zadaného ukazatele znaků.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Při přepsání v odvozené třídě dekóduje všechny bajty v zadaném bajtu jen pro čtení do rozsahu znaků. (Zděděno od Encoding)
GetDecoder()	Získá dekodér, který převede sekvenci bajtů s kódováním UTF-32 na sekvenci znaků Unicode.
GetEncoder()	Získá kodér, který převede posloupnost znaků Unicode na posloupnost kódování UTF-32 bajtů.
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í znak pořadí bajtů Unicode kódovaný ve formátu UTF-32, pokud UTF32Encoding je objekt nakonfigurovaný tak, aby ho mohl zadat.
GetString(Byte[], Int32, Int32)	Dekóduje rozsah bajtů z bajtového pole do řetězce.
GetString(Byte[])	Při přepsání v odvozené třídě dekóduje všechny bajty v zadané bajtové pole do řetězce. (Zděděno od Encoding)
GetString(Byte*, Int32)	Při přepsání v odvozené třídě dekóduje zadaný počet bajtů počínaje zadanou adresou do řetězce. (Zděděno od Encoding)
GetString(ReadOnlySpan<Byte>)	Při přepsání v odvozené třídě dekóduje všechny bajty v zadaném bajtu rozsahu do řetězce. (Zděděno od Encoding)
GetType()	Získá Type 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áno pomocí výchozího normalizačního formuláře. (Zděděno od Encoding)
IsAlwaysNormalized(NormalizationForm)	Při přepsání v odvozené třídě získá hodnotu určující, zda je aktuální kódování vždy normalizováno pomocí zadaného normalizačního formuláře. (Zděděno od Encoding)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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)	Zakó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í

Name	Description
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Dekóduje zadané ReadOnlySequence<T> na `byte`s pomocí zadaného Encoding a zapíše výsledek na `writer`.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Zakóduje zadané ReadOnlySequence<T> do `byte`s pomocí zadaného Encoding a výstupu výsledek do `bytes`.
GetBytes(Encoding, ReadOnlySequence<Char>)	Zakóduje zadaný ReadOnlySequence<T> do Byte pole pomocí zadaného Encodingpole .
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Zakóduje zadanou ReadOnlySpan<T> hodnotu tak, aby `byte`používala zadanou Encoding hodnotu, a zapíše výsledek do `writer`.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Dekóduje zadané ReadOnlySequence<T> na `char`s pomocí zadaného Encoding a zapíše výsledek na `writer`.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Dekóduje zadané ReadOnlySequence<T> na `char`s pomocí zadaného Encoding a výstupu výsledek na `chars`.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Dekóduje zadané ReadOnlySpan<T> na `char`s pomocí zadaného Encoding a zapíše výsledek na `writer`.
GetString(Encoding, ReadOnlySequence<Byte>)	Dekóduje zadaný ReadOnlySequence<T> do zadaného String Encoding.

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?