UTF32Encoding Klas

Definitie

Naamruimte:: System.Text

Assembly's:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: System.Text.Encoding.Extensions.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een UTF-32-codering van Unicode-tekens.

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

Overname: Object

Encoding
UTF32Encoding

Kenmerken: SerializableAttribute

Voorbeelden

In het volgende voorbeeld ziet u het gedrag van UTF32Encoding objecten waarvoor en zonder foutdetectie is ingeschakeld. Er wordt een bytematrix gemaakt waarvan de laatste vier bytes een ongeldig surrogaatpaar vertegenwoordigen; de hoge surrogaat U+D8FF wordt gevolgd door een U+01FF, die buiten het bereik van lage surrogaten (0xDC00 tot 0xDFFF). Zonder foutdetectie gebruikt de UTF32-decoder vervangende terugval om het ongeldige surrogaatpaar te vervangen door VERVANGEND TEKEN (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̆ǽβ�

In het volgende voorbeeld wordt een tekenreeks van Unicode-tekens gecodeerd in een bytematrix met behulp van een UTF32Encoding object. De bytematrix wordt vervolgens gedecodeerd in een tekenreeks om aan te tonen dat er geen gegevensverlies is.

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 (Σ).

In het volgende voorbeeld wordt dezelfde tekenreeks als de vorige gebruikt, behalve dat de gecodeerde bytes naar een bestand worden geschreven en de bytestroom voorafgaat door een bytevolgordemarkering (BOM). Vervolgens wordt het bestand op twee verschillende manieren gelezen: als tekstbestand met behulp van een StreamReader object en als binair bestand. Zoals u zou verwachten, bevat geen nieuwe tekenreeks de bom.

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 (Σ).

Opmerkingen

Encoding is het proces van het transformeren van een set Unicode-tekens in een reeks bytes. Decodering is het proces van het transformeren van een reeks gecodeerde bytes in een set Unicode-tekens.

De Unicode-standaard wijst een codepunt (een getal) toe aan elk teken in elk ondersteund script. Een Unicode Transformation Format (UTF) is een manier om dat codepunt te coderen. De Unicode-standaard maakt gebruik van de volgende UDF's:

UTF-8, die elk codepunt vertegenwoordigt als een reeks van één tot vier bytes.
UTF-16, die elk codepunt vertegenwoordigt als een reeks van één tot twee 16-bits gehele getallen.
UTF-32, die elk codepunt vertegenwoordigt als een 32-bits geheel getal.

Zie Character Encoding in .NET voor meer informatie over de UDF's en andere coderingen die worden ondersteund door System.Text.

De UTF32Encoding klasse vertegenwoordigt een UTF-32-codering. De encoder kan de big endian bytevolgorde (de belangrijkste byte eerst) of de kleine endian bytevolgorde (minst significante byte eerst) gebruiken. De Latijnse hoofdletter A (codepunt U+0041) wordt bijvoorbeeld als volgt geserialiseerd (in hexadecimaal):

Big endian byte order: 00 00 00 41
Little endian byte order: 41 00 00 00

Het is over het algemeen efficiënter om Unicode-tekens op te slaan met behulp van de systeemeigen bytevolgorde. Het is bijvoorbeeld beter om de bytevolgorde little endian te gebruiken op little endian-platforms, zoals Intel-computers. UTF32Encoding komt overeen met de Windows codepagina's 12000 (little endian byte order) en 12001 (big endian byte order). U kunt de 'endianness' van een bepaalde architectuur bepalen door de methode aan te BitConverter.IsLittleEndian roepen.

Optioneel biedt het UTF32Encoding object een bytevolgordemarkering (BOM), een matrix van bytes die kan worden voorafgegaan door de reeks bytes die het gevolg zijn van het coderingsproces. Als de preambule een bytevolgorde (BOM) bevat, helpt de decoder de bytevolgorde en de transformatienotatie of UTF van een bytematrix te bepalen.

Als het UTF32Encoding exemplaar is geconfigureerd om een stuklijst op te geven, kunt u deze ophalen door de GetPreamble methode aan te roepen. Anders retourneert de methode een lege matrix. Houd er rekening mee dat, zelfs als een UTF32Encoding object is geconfigureerd voor BOM-ondersteuning, u de BOM moet opnemen aan het begin van de gecodeerde bytestroom, indien van toepassing. De coderingsmethoden van de UTF32Encoding klasse doen dit niet automatisch.

Caution

Als u foutdetectie wilt inschakelen en het klasse-exemplaar veiliger wilt maken, moet u een UTF32Encoding object instantiëren door de UTF32Encoding(Boolean, Boolean, Boolean) constructor aan te roepen en het argument in throwOnInvalidBytes te stellen op true. Met foutdetectie genereert een methode die een ongeldige reeks tekens of bytes detecteert een ArgumentException uitzondering. Zonder foutdetectie wordt er geen uitzondering gegenereerd en wordt de ongeldige volgorde over het algemeen genegeerd.

U kunt een UTF32Encoding object op verschillende manieren instantiëren, afhankelijk van of u een bytevolgordemarkering (BOM) wilt opgeven, of u nu big-endian- of little-endian-codering wilt, en of u foutdetectie wilt inschakelen. De volgende tabel bevat de UTF32Encoding constructors en de Encoding eigenschappen die een UnicodeEncoding object retourneren.

Lid	Bytevolgorde	STUKLIJST	Foutdetectie
Encoding.UTF32	Little Endian	Ja	Nee (vervanging terugval)
UTF32Encoding.UTF32Encoding()	Little Endian	Ja	Nee (vervanging terugval)
UTF32Encoding.UTF32Encoding(Boolean, Boolean)	Configurable	Configurable	Nee (vervanging terugval)
UTF32Encoding.UTF32Encoding(Boolean, Boolean, Boolean)	Configurable	Configurable	Configurable

De GetByteCount methode bepaalt hoeveel bytes resulteren in het coderen van een set Unicode-tekens en de GetBytes methode voert de daadwerkelijke codering uit.

Op dezelfde manier bepaalt de GetCharCount methode hoeveel tekens resulteren in het decoderen van een reeks bytes, en de GetChars en GetString methoden voeren de daadwerkelijke decodering uit.

Voor een encoder of decoder die statusinformatie kan opslaan bij het coderen of decoderen van gegevens die meerdere blokken omvatten (zoals een tekenreeks van 1 miljoen tekens die in segmenten van 100.000 tekens zijn gecodeerd), gebruikt u respectievelijk de GetEncoder en GetDecoder eigenschappen.

Constructors

Name	Description
UTF32Encoding()	Initialiseert een nieuw exemplaar van de UTF32Encoding klasse.
UTF32Encoding(Boolean, Boolean, Boolean)	Initialiseert een nieuw exemplaar van de UTF32Encoding klasse. Parameters geven aan of de big endian-bytevolgorde moet worden gebruikt, of een Unicode-bytevolgorde moet worden opgegeven en of er een uitzondering moet worden gegenereerd wanneer een ongeldige codering wordt gedetecteerd.
UTF32Encoding(Boolean, Boolean)	Initialiseert een nieuw exemplaar van de UTF32Encoding klasse. Parameters geven aan of de big endian bytevolgorde moet worden gebruikt en of de GetPreamble() methode een Unicode-bytevolgordemarkering retourneert.

Eigenschappen

Name	Description
BodyName	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een naam voor de huidige codering die kan worden gebruikt met hoofdtags van de e-mailagent. (Overgenomen van Encoding)
CodePage	Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de codepagina-id van de huidige Encodingop. (Overgenomen van Encoding)
DecoderFallback	Hiermee wordt het DecoderFallback object voor het huidige Encoding object opgehaald of ingesteld. (Overgenomen van Encoding)
EncoderFallback	Hiermee wordt het EncoderFallback object voor het huidige Encoding object opgehaald of ingesteld. (Overgenomen van Encoding)
EncodingName	Wanneer deze wordt overschreven in een afgeleide klasse, wordt de leesbare beschrijving van de huidige codering opgehaald. (Overgenomen van Encoding)
HeaderName	Wanneer deze worden overschreven in een afgeleide klasse, krijgt u een naam voor de huidige codering die kan worden gebruikt met headertags van de e-mailagent. (Overgenomen van Encoding)
IsBrowserDisplay	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door browserclients om inhoud weer te geven. (Overgenomen van Encoding)
IsBrowserSave	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door browserclients voor het opslaan van inhoud. (Overgenomen van Encoding)
IsMailNewsDisplay	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door mail- en nieuwsclients om inhoud weer te geven. (Overgenomen van Encoding)
IsMailNewsSave	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door e-mail- en nieuwsclients om inhoud op te slaan. (Overgenomen van Encoding)
IsReadOnly	Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde opgehaald die aangeeft of de huidige codering het kenmerk Alleen-lezen heeft. (Overgenomen van Encoding)
IsSingleByte	Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde opgehaald die aangeeft of de huidige codering gebruikmaakt van codepunten met één byte. (Overgenomen van Encoding)
Preamble	Wanneer deze wordt overschreven in een afgeleide klasse, retourneert u een bereik met de reeks bytes die de gebruikte codering aangeeft. (Overgenomen van Encoding)
WebName	Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de naam op die is geregistreerd bij de Internet Assigned Numbers Authority (IANA) voor de huidige codering. (Overgenomen van Encoding)
WindowsCodePage	Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de Windows codepagina van het besturingssysteem op die het meest overeenkomt met de huidige codering. (Overgenomen van Encoding)

Methoden

Name	Description
Clone()	Wanneer deze wordt overschreven in een afgeleide klasse, maakt u een ondiepe kopie van het huidige Encoding object. (Overgenomen van Encoding)
Equals(Object)	Bepaalt of de opgegeven Object waarde gelijk is aan het huidige UTF32Encoding object.
GetByteCount(Char[], Int32, Int32)	Berekent het aantal bytes dat wordt geproduceerd door een set tekens van de opgegeven tekenmatrix te coderen.
GetByteCount(Char[])	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door alle tekens in de opgegeven tekenmatrix te coderen. (Overgenomen van Encoding)
GetByteCount(Char*, Int32)	Berekent het aantal bytes dat wordt geproduceerd door een set tekens te coderen die beginnen bij de opgegeven tekenwijzer.
GetByteCount(ReadOnlySpan<Char>)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door de tekens in het opgegeven tekenbereik te coderen. (Overgenomen van Encoding)
GetByteCount(String, Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door een set tekens van de opgegeven tekenreeks te coderen. (Overgenomen van Encoding)
GetByteCount(String)	Berekent het aantal bytes dat wordt geproduceerd door de tekens in de opgegeven Stringcode te coderen.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Codeert een set tekens van de opgegeven tekenmatrix in de opgegeven bytematrix.
GetBytes(Char[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u een set tekens van de opgegeven tekenmatrix in een reeks bytes. (Overgenomen van Encoding)
GetBytes(Char[])	Wanneer deze worden overschreven in een afgeleide klasse, codeert u alle tekens in de opgegeven tekenmatrix in een reeks bytes. (Overgenomen van Encoding)
GetBytes(Char, Int32, Byte, Int32)	Codeert een reeks tekens die beginnen bij de opgegeven tekenwijzer in een reeks bytes die zijn opgeslagen vanaf de opgegeven byte-aanwijzer.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u in een reeks bytes die een reeks tekens bevat van de opgegeven alleen-lezen periode. (Overgenomen van Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Codeert een set tekens van de opgegeven in de opgegeven String bytematrix.
GetBytes(String, Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u in een matrix van bytes het aantal tekens dat is opgegeven in `count` de opgegeven tekenreeks, beginnend bij de opgegeven `index`tekenreeks. (Overgenomen van Encoding)
GetBytes(String)	Wanneer deze worden overschreven in een afgeleide klasse, codeert u alle tekens in de opgegeven tekenreeks in een reeks bytes. (Overgenomen van Encoding)
GetCharCount(Byte[], Int32, Int32)	Berekent het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes van de opgegeven bytematrix.
GetCharCount(Byte[])	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door alle bytes in de opgegeven bytematrix te decoderen. (Overgenomen van Encoding)
GetCharCount(Byte*, Int32)	Berekent het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes die beginnen bij de opgegeven byteaanwijzer.
GetCharCount(ReadOnlySpan<Byte>)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door de opgegeven bytespanne met het kenmerk Alleen-lezen te decoderen. (Overgenomen van Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Decodeert een reeks bytes van de opgegeven bytematrix in de opgegeven tekenmatrix.
GetChars(Byte[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u een reeks bytes van de opgegeven bytematrix in een reeks tekens. (Overgenomen van Encoding)
GetChars(Byte[])	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u alle bytes in de opgegeven bytematrix in een set tekens. (Overgenomen van Encoding)
GetChars(Byte, Int32, Char, Int32)	Decodeert een reeks bytes die beginnen bij de opgegeven byteaanwijzer in een set tekens die zijn opgeslagen vanaf de opgegeven tekenaanwijzer.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Wanneer deze wordt overschreven in een afgeleide klasse, decodeert u alle bytes in de opgegeven bytespanne met het kenmerk Alleen-lezen in een tekenbereik. (Overgenomen van Encoding)
GetDecoder()	Hiermee haalt u een decoder op die een UTF-32 gecodeerde reeks bytes converteert naar een reeks Unicode-tekens.
GetEncoder()	Hiermee haalt u een coderingsprogramma op waarmee een reeks Unicode-tekens wordt geconverteerd naar een UTF-32 gecodeerde reeks bytes.
GetHashCode()	Retourneert de hash-code voor het huidige exemplaar.
GetMaxByteCount(Int32)	Berekent het maximum aantal bytes dat wordt geproduceerd door het opgegeven aantal tekens te coderen.
GetMaxCharCount(Int32)	Berekent het maximum aantal tekens dat wordt geproduceerd door het opgegeven aantal bytes te decoderen.
GetPreamble()	Retourneert een Unicode byte ordermarkering die is gecodeerd in UTF-32-indeling, als het UTF32Encoding object is geconfigureerd om er een op te geven.
GetString(Byte[], Int32, Int32)	Decodeert een bereik van bytes van een bytematrix in een tekenreeks.
GetString(Byte[])	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u alle bytes in de opgegeven bytematrix in een tekenreeks. (Overgenomen van Encoding)
GetString(Byte*, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u een opgegeven aantal bytes dat begint bij een opgegeven adres in een tekenreeks. (Overgenomen van Encoding)
GetString(ReadOnlySpan<Byte>)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u alle bytes in de opgegeven byte span in een tekenreeks. (Overgenomen van Encoding)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
IsAlwaysNormalized()	Hiermee wordt een waarde opgehaald die aangeeft of de huidige codering altijd is genormaliseerd, met behulp van de standaardnormalisatievorm. (Overgenomen van Encoding)
IsAlwaysNormalized(NormalizationForm)	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering altijd is genormaliseerd, met behulp van de opgegeven normalisatievorm. (Overgenomen van Encoding)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?