UnicodeEncoding Třída

Definice

public ref class UnicodeEncoding : System::Text::Encoding

public class UnicodeEncoding : System.Text.Encoding

[System.Serializable]
public class UnicodeEncoding : System.Text.Encoding

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class UnicodeEncoding : System.Text.Encoding

type UnicodeEncoding = class
    inherit Encoding

[<System.Serializable>]
type UnicodeEncoding = class
    inherit Encoding

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type UnicodeEncoding = class
    inherit Encoding

Public Class UnicodeEncoding
Inherits Encoding

Dědičnost

Object

Encoding

UnicodeEncoding

Atributy

SerializableAttribute ComVisibleAttribute

Příklady

Následující příklad ukazuje, jak kódovat řetězec znaků Unicode do pole bajtů pomocí objektu UnicodeEncoding . Bajtové pole je dekódováno do řetězce, který demonstruje, že nedojde ke ztrátě dat.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   
   // The encoding.
   UnicodeEncoding^ unicode = gcnew UnicodeEncoding;
   
   // Create a String* that contains Unicode characters.
   String^ unicodeString = L"This Unicode string contains two characters with codes outside the traditional ASCII code range, Pi (\u03a0) and Sigma (\u03a3).";
   Console::WriteLine( "Original string:" );
   Console::WriteLine( unicodeString );
   
   // Encode the String*.
   array<Byte>^encodedBytes = unicode->GetBytes( unicodeString );
   Console::WriteLine();
   Console::WriteLine( "Encoded bytes:" );
   IEnumerator^ myEnum = encodedBytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
   
   // Decode bytes back to String*.
   // Notice Pi and Sigma characters are still present.
   String^ decodedString = unicode->GetString( encodedBytes );
   Console::WriteLine();
   Console::WriteLine( "Decoded bytes:" );
   Console::WriteLine( decodedString );
}

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        // The encoding.
        UnicodeEncoding unicode = new UnicodeEncoding();
        
        // Create a string that contains Unicode characters.
        String unicodeString =
            "This Unicode string contains two characters " +
            "with codes outside the traditional ASCII code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = unicode.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
        
        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = unicode.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        ' The encoding.
        Dim uni As New UnicodeEncoding()
        
        ' Create a string that contains Unicode characters.
        Dim unicodeString As String = _
            "This Unicode string contains two characters " & _
            "with codes outside the traditional ASCII code range, " & _
            "Pi (" & ChrW(928) & ") and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        
        ' Encode the string.
        Dim encodedBytes As Byte() = uni.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Dim b As Byte
        For Each b In  encodedBytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
        
        ' Decode bytes back to string.
        ' Notice Pi and Sigma characters are still present.
        Dim decodedString As String = uni.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class

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

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

public class Example
{
   public static void Main()
   {
        // Create a UTF-16 encoding that supports a BOM.
        Encoding unicode = new UnicodeEncoding();

        // A Unicode string with two characters outside an 8-bit code range.
        String unicodeString =
            "This Unicode string has 2 characters outside the " +
            "ASCII range: \n" +
            "Pi (\u03A0)), and Sigma (\u03A3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);
        Console.WriteLine();

        // Encode the string.
        Byte[] encodedBytes = unicode.GetBytes(unicodeString);
        Console.WriteLine("The encoded string has {0} bytes.\n",
                          encodedBytes.Length);

        // Write the bytes to a file with a BOM.
        var fs = new FileStream(@".\UTF8Encoding.txt", FileMode.Create);
        Byte[] bom = unicode.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(@".\UTF8Encoding.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(@".\UTF8Encoding.txt", FileMode.Open);
        Byte[] bytes = new Byte[fs.Length];
        fs.Read(bytes, 0, (int)fs.Length);
        fs.Close();

        String decodedString = unicode.GetString(bytes);
        Console.WriteLine("Decoded bytes:");
        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 172 bytes.
//
//    Wrote 174 bytes to the file.
//
//    String read using StreamReader:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    Decoded bytes:
//    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-16 encoding that supports a BOM.
        Dim unicode As New UnicodeEncoding()
        
        ' A Unicode string with two characters outside an 8-bit code range.
        Dim unicodeString 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(unicodeString)
        Console.WriteLine()
        
        ' Encode the string.
        Dim encodedBytes As Byte() = unicode.GetBytes(unicodeString)
        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(".\UnicodeEncoding.txt", FileMode.Create)
        Dim bom() As Byte = unicode.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(".\UnicodeEncoding.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(".\UnicodeEncoding.txt", FileMode.Open)
        Dim bytes(fs.Length - 1) As Byte
        fs.Read(bytes, 0, fs.Length)
        fs.Close()

        Dim decodedString As String = unicode.GetString(bytes)
        Console.WriteLine("Decoded bytes:")
        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 172 bytes.
'
'    Wrote 174 bytes to the file.
'
'    String read using StreamReader:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).
'
'    Decoded bytes:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).

Poznámky

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

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

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

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

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

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

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

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

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

Obecně je efektivnější ukládat znaky Unicode pomocí nativního pořadí bajtů konkrétní platformy. Například je lepší použít pořadí bajtů little endian na malých endian platformách, jako jsou počítače Intel. Třída UnicodeEncoding odpovídá znakovým stránkám Windows 1200 (malé pořadí bajtů endian) a 1201 (pořadí bajtů big endian). "Endianness" konkrétní architektury můžete určit voláním BitConverter.IsLittleEndian metody .

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

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

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

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

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

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

Konstruktory

Pole

Vlastnosti

Metody

Metody rozšíření

Platí pro

Viz také

• Encoding
• Encoder
• Decoder
• UTF32Encoding
• UTF8Encoding
• UTF7Encoding
• ASCIIEncoding
• UnicodeCategory
• CharUnicodeInfo
• Principy kódování