UTF32Encoding Klass

Definition

Namnområde:: System.Text

Sammansättningar:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Sammansättning:: mscorlib.dll

Sammansättning:: System.Text.Encoding.Extensions.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Representerar en UTF-32-kodning av Unicode-tecken.

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

Arv: Object

Encoding
UTF32Encoding

Attribut: SerializableAttribute

Exempel

I följande exempel visas beteendet UTF32Encoding för objekt med och utan felidentifiering aktiverat. Den skapar en bytematris vars senaste fyra byte representerar ett ogiltigt surrogatpar. den höga surrogat U + D8FF följs av en U + 01FF, som ligger utanför intervallet av låga surrogater (0xDC00 genom 0xDFFF). Utan felidentifiering använder UTF32-avkodaren ersättningsåterställning för att ersätta det ogiltiga surrogatparet med REPLACEMENT 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̆ǽβ�

I följande exempel kodas en sträng med Unicode-tecken till en bytematris med hjälp av ett UTF32Encoding objekt. Byte-matrisen avkodas sedan till en sträng för att visa att det inte finns någon dataförlust.

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

I följande exempel används samma sträng som den föregående, förutom att den skriver kodade byte till en fil och prefixar byteströmmen med en byteordningsmarkering (BOM). Den läser sedan filen på två olika sätt: som en textfil med hjälp av ett StreamReader objekt och som en binär fil. Som förväntat innehåller ingen av de nyligen lästa strängarna bommen.

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

Kommentarer

Kodning är processen att omvandla en uppsättning Unicode-tecken till en sekvens med byte. Avkodning är processen att omvandla en sekvens med kodade byte till en uppsättning Unicode-tecken.

Unicode Standard tilldelar en kodpunkt (ett tal) till varje tecken i varje skript som stöds. Ett Unicode Transformation Format (UTF) är ett sätt att koda kodpunkten. Unicode Standard använder följande UTF:er:

UTF-8, som representerar varje kodpunkt som en sekvens på en till fyra byte.
UTF-16, som representerar varje kodpunkt som en sekvens med ett till två 16-bitars heltal.
UTF-32, som representerar varje kodpunkt som ett 32-bitars heltal.

Mer information om UTF:er och andra kodningar som stöds av System.Text finns i Character Encoding i .NET.

Klassen UTF32Encoding representerar en UTF-32-kodning. Kodaren kan använda den stora endianska byteordningen (mest betydande byte först) eller den lilla endianska byteordningen (minst betydande byte först). Till exempel serialiseras latinsk versal bokstav A (kodpunkt U+0041) enligt följande (i hexadecimal):

Stor endiansk byteordning: 00 00 00 41
Lite endiansk byteordning: 41 00 00 00

Det är vanligtvis mer effektivt att lagra Unicode-tecken med den interna byteordningen. Det är till exempel bättre att använda den lilla endianska byteordningen på små endianska plattformar, till exempel Intel-datorer. UTF32Encoding motsvarar Windows kodsidorna 12000 (lite endiansk byteordning) och 12001 (stor endiansk byteordning). Du kan fastställa "endianness" för en viss arkitektur genom att anropa BitConverter.IsLittleEndian metoden.

UTF32Encoding Om du vill kan objektet ange ett byteordningsmärke (BOM), som är en matris med byte som kan prefixeras till sekvensen med byte som härrör från kodningsprocessen. Om ingressen innehåller ett byteordningsmärke (BOM) hjälper det avkodaren att fastställa byteordningen och transformeringsformatet eller UTF för en bytematris.

Om instansen UTF32Encoding är konfigurerad för att tillhandahålla en strukturlista kan du hämta den GetPreamble genom att anropa metoden. Annars returnerar metoden en tom matris. Observera att även om ett UTF32Encoding objekt har konfigurerats för bomstöd måste du inkludera strukturlistan i början av den kodade byteströmmen efter behov. Kodningsmetoderna för UTF32Encoding klassen gör inte detta automatiskt.

Caution

Om du vill aktivera felidentifiering och göra klassinstansen säkrare bör du instansiera ett UTF32Encoding objekt genom att anropa UTF32Encoding(Boolean, Boolean, Boolean) konstruktorn och ange dess throwOnInvalidBytes argument till true. Med felidentifiering utlöser en metod som identifierar en ogiltig sekvens med tecken eller byte ett ArgumentException undantag. Utan felidentifiering genereras inget undantag och den ogiltiga sekvensen ignoreras vanligtvis.

Du kan instansiera ett UTF32Encoding objekt på flera olika sätt, beroende på om du vill ange ett byteordningsmärke (BOM), om du vill ha stor endiansk eller lite endiansk kodning och om du vill aktivera felidentifiering. I följande tabell visas konstruktorerna UTF32Encoding och egenskaperna Encoding som returnerar ett UnicodeEncoding objekt.

Medlem	Byteordning	STRUKTURLISTA	Feldetektering
Encoding.UTF32	Little-endian	Yes	Nej (reserv för ersättning)
UTF32Encoding.UTF32Encoding()	Little-endian	Yes	Nej (reserv för ersättning)
UTF32Encoding.UTF32Encoding(Boolean, Boolean)	Konfigureringsbart	Konfigureringsbart	Nej (reserv för ersättning)
UTF32Encoding.UTF32Encoding(Boolean, Boolean, Boolean)	Konfigureringsbart	Konfigureringsbart	Konfigureringsbart

Metoden GetByteCount avgör hur många byte som resulterar i kodning av en uppsättning Unicode-tecken och GetBytes metoden utför den faktiska kodningen.

GetCharCount På samma sätt avgör metoden hur många tecken som resulterar i avkodning av en sekvens med byte, och GetChars metoderna och GetString utför den faktiska avkodningen.

För en kodare eller avkodare som kan spara tillståndsinformation vid kodning eller avkodning av data som sträcker sig över flera block (till exempel en sträng med 1 miljon tecken som kodas i segment med 100 000 tecken) använder GetEncoder du egenskaperna och GetDecoder .

Konstruktorer

Name	Description
UTF32Encoding()	Initierar en ny instans av UTF32Encoding klassen.
UTF32Encoding(Boolean, Boolean, Boolean)	Initierar en ny instans av UTF32Encoding klassen. Parametrar anger om du vill använda den stora slutpunktsbyteordningen, om du vill ange ett Unicode-byteordningsmärke och om ett undantag ska utlösas när en ogiltig kodning identifieras.
UTF32Encoding(Boolean, Boolean)	Initierar en ny instans av UTF32Encoding klassen. Parametrar anger om du vill använda den stora slutpunktsbyteordningen GetPreamble() och om metoden returnerar ett Unicode-byteordningsmärke.

Egenskaper

Name	Description
BodyName	När det åsidosätts i en härledd klass får du ett namn för den aktuella kodningen som kan användas med e-postagentens brödtexttaggar. (Ärvd från Encoding)
CodePage	När du åsidosättas i en härledd klass hämtar du kodsideidentifieraren för den aktuella Encoding. (Ärvd från Encoding)
DecoderFallback	Hämtar eller anger objektet DecoderFallback för det aktuella Encoding objektet. (Ärvd från Encoding)
EncoderFallback	Hämtar eller anger objektet EncoderFallback för det aktuella Encoding objektet. (Ärvd från Encoding)
EncodingName	När den åsidosättas i en härledd klass hämtar den läsbara beskrivningen av den aktuella kodningen. (Ärvd från Encoding)
HeaderName	När det åsidosätts i en härledd klass får du ett namn för den aktuella kodningen som kan användas med rubriktaggar för e-postagenten. (Ärvd från Encoding)
IsBrowserDisplay	När den åsidosättas i en härledd klass får ett värde som anger om den aktuella kodningen kan användas av webbläsarklienter för att visa innehåll. (Ärvd från Encoding)
IsBrowserSave	När det åsidosätts i en härledd klass får ett värde som anger om den aktuella kodningen kan användas av webbläsarklienter för att spara innehåll. (Ärvd från Encoding)
IsMailNewsDisplay	När den åsidosättas i en härledd klass får du ett värde som anger om den aktuella kodningen kan användas av e-post- och nyhetsklienter för att visa innehåll. (Ärvd från Encoding)
IsMailNewsSave	När den åsidosätts i en härledd klass får du ett värde som anger om den aktuella kodningen kan användas av e-post- och nyhetsklienter för att spara innehåll. (Ärvd från Encoding)
IsReadOnly	När den åsidosättas i en härledd klass får du ett värde som anger om den aktuella kodningen är skrivskyddad. (Ärvd från Encoding)
IsSingleByte	När det åsidosättas i en härledd klass får du ett värde som anger om den aktuella kodningen använder kodpunkter med en enda byte. (Ärvd från Encoding)
Preamble	När det åsidosätts i en härledd klass returneras ett intervall som innehåller sekvensen med byte som anger den kodning som används. (Ärvd från Encoding)
WebName	När det åsidosätts i en härledd klass, hämtar det namn som registrerats med IANA (Internet Assigned Numbers Authority) för den aktuella kodningen. (Ärvd från Encoding)
WindowsCodePage	När den åsidosätts i en härledd klass hämtar den kodsida för Windows operativsystem som närmast motsvarar den aktuella kodningen. (Ärvd från Encoding)

Metoder

Name	Description
Clone()	När du åsidosättas i en härledd klass skapar du en ytlig kopia av det aktuella Encoding objektet. (Ärvd från Encoding)
Equals(Object)	Avgör om det angivna Object är lika med det aktuella UTF32Encoding objektet.
GetByteCount(Char[], Int32, Int32)	Beräknar antalet byte som skapas genom att koda en uppsättning tecken från den angivna teckenmatrisen.
GetByteCount(Char[])	När det åsidosättas i en härledd klass beräknas antalet byte som skapas genom att koda alla tecken i den angivna teckenmatrisen. (Ärvd från Encoding)
GetByteCount(Char*, Int32)	Beräknar antalet byte som skapas genom att koda en uppsättning tecken med början vid den angivna teckenpekaren.
GetByteCount(ReadOnlySpan<Char>)	När det åsidosättas i en härledd klass beräknas antalet byte som genereras genom att koda tecknen i det angivna teckenintervallet. (Ärvd från Encoding)
GetByteCount(String, Int32, Int32)	När du åsidosättas i en härledd klass beräknar du antalet byte som genereras genom att koda en uppsättning tecken från den angivna strängen. (Ärvd från Encoding)
GetByteCount(String)	Beräknar antalet byte som genereras genom att koda tecknen i den angivna String.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Kodar en uppsättning tecken från den angivna teckenmatrisen till den angivna bytematrisen.
GetBytes(Char[], Int32, Int32)	När den åsidosättas i en härledd klass kodar en uppsättning tecken från den angivna teckenmatrisen till en sekvens med byte. (Ärvd från Encoding)
GetBytes(Char[])	När det åsidosättas i en härledd klass kodas alla tecken i den angivna teckenmatrisen till en sekvens med byte. (Ärvd från Encoding)
GetBytes(Char, Int32, Byte, Int32)	Kodar en uppsättning tecken som börjar vid den angivna teckenpekaren till en sekvens med byte som lagras från och med den angivna bytepekaren.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	När det åsidosättas i en härledd klass kodar till ett intervall med byte en uppsättning tecken från det angivna skrivskyddade intervallet. (Ärvd från Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Kodar en uppsättning tecken från den angivna String i den angivna bytematrisen.
GetBytes(String, Int32, Int32)	När det åsidosättas i en härledd klass kodar till en matris med byte det antal tecken som anges av `count` i den angivna strängen, med början från den angivna `index`. (Ärvd från Encoding)
GetBytes(String)	När det åsidosättas i en härledd klass kodar alla tecken i den angivna strängen till en sekvens med byte. (Ärvd från Encoding)
GetCharCount(Byte[], Int32, Int32)	Beräknar antalet tecken som genereras genom avkodning av en sekvens med byte från den angivna bytematrisen.
GetCharCount(Byte[])	När det åsidosättas i en härledd klass beräknas antalet tecken som genereras genom avkodning av alla byte i den angivna bytematrisen. (Ärvd från Encoding)
GetCharCount(Byte*, Int32)	Beräknar antalet tecken som genereras genom avkodning av en sekvens med byte som börjar vid den angivna bytepekaren.
GetCharCount(ReadOnlySpan<Byte>)	När det åsidosättas i en härledd klass beräknas antalet tecken som genereras genom avkodning av det angivna skrivskyddade byteintervallet. (Ärvd från Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Avkodar en sekvens med byte från den angivna bytematrisen till den angivna teckenmatrisen.
GetChars(Byte[], Int32, Int32)	När den åsidosättas i en härledd klass avkodas en sekvens med byte från den angivna bytematrisen till en uppsättning tecken. (Ärvd från Encoding)
GetChars(Byte[])	När de åsidosättas i en härledd klass avkodas alla byte i den angivna bytematrisen till en uppsättning tecken. (Ärvd från Encoding)
GetChars(Byte, Int32, Char, Int32)	Avkodar en sekvens med byte som börjar vid den angivna bytepekaren till en uppsättning tecken som lagras från och med den angivna teckenpekaren.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	När de åsidosättas i en härledd klass avkodas alla byte i det angivna skrivskyddade byteintervallet till ett teckenintervall. (Ärvd från Encoding)
GetDecoder()	Hämtar en dekodare som konverterar en UTF-32-kodad sekvens med byte till en sekvens med Unicode-tecken.
GetEncoder()	Hämtar en kodare som konverterar en sekvens med Unicode-tecken till en UTF-32-kodad sekvens med byte.
GetHashCode()	Returnerar hash-koden för den aktuella instansen.
GetMaxByteCount(Int32)	Beräknar det maximala antalet byte som genereras genom kodning av det angivna antalet tecken.
GetMaxCharCount(Int32)	Beräknar det maximala antalet tecken som genereras genom avkodning av det angivna antalet byte.
GetPreamble()	Returnerar ett Unicode-byteordningsmärke som är kodat i UTF-32-format, om UTF32Encoding objektet är konfigurerat att ange ett.
GetString(Byte[], Int32, Int32)	Avkodar ett intervall med byte från en bytematris till en sträng.
GetString(Byte[])	När de åsidosättas i en härledd klass avkodas alla byte i den angivna bytematrisen till en sträng. (Ärvd från Encoding)
GetString(Byte*, Int32)	När det åsidosättas i en härledd klass avkodas ett angivet antal byte som börjar vid en angiven adress till en sträng. (Ärvd från Encoding)
GetString(ReadOnlySpan<Byte>)	När de åsidosättas i en härledd klass avkodas alla byte i det angivna byteintervallet till en sträng. (Ärvd från Encoding)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
IsAlwaysNormalized()	Hämtar ett värde som anger om den aktuella kodningen alltid normaliseras med standardnormaliseringsformuläret. (Ärvd från Encoding)
IsAlwaysNormalized(NormalizationForm)	När den åsidosättas i en härledd klass får du ett värde som anger om den aktuella kodningen alltid normaliseras med hjälp av det angivna normaliseringsformuläret. (Ärvd från Encoding)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?