UnicodeEncoding Sınıf

Tanım

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

Devralma

Object

Encoding

UnicodeEncoding

Öznitelikler

SerializableAttribute ComVisibleAttribute

Örnekler

Aşağıdaki örnekte, bir Unicode karakter dizesinin bir nesne kullanılarak UnicodeEncoding bayt dizisine nasıl kodlandığı gösterilmektedir. Bayt dizisinin kodu, veri kaybı olmadığını göstermek için bir dizeye dönüştürülür.

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

Aşağıdaki örnek, kodlanmış baytları bir dosyaya yazması ve bayt akışına bayt sırası işareti (BOM) öneki eklemesi dışında, öncekiyle aynı dizeyi kullanır. Ardından dosyayı iki farklı şekilde okur: bir nesne kullanarak StreamReader metin dosyası olarak ve ikili dosya olarak. Beklediğiniz gibi, yeni okunan dizelerin hiçbiri BOM'u içermez.

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

Açıklamalar

Kodlama, bir Unicode karakter kümesini bayt dizisine dönüştürme işlemidir. Kod çözme, kodlanmış bayt dizisini unicode karakter kümesine dönüştürme işlemidir.

Unicode Standardı, desteklenen her betikteki her karaktere bir kod noktası (sayı) atar. Unicode Dönüştürme Biçimi (UTF), bu kod noktasını kodlamanın bir yoludur. Unicode Standardı aşağıdaki UTF'leri kullanır:

• UtF-8, her kod noktasını bir ile dört baytlık bir dizi olarak temsil eder.

• UtF-16, her kod noktasını bir-iki 16 bit tamsayı dizisi olarak temsil eder.

• Her kod noktasını 32 bitlik bir tamsayı olarak temsil eden UTF-32.

TARAFıNDAN System.Textdesteklenen UTF'ler ve diğer kodlamalar hakkında daha fazla bilgi için .NET Framework karakter kodlama bölümüne bakın.

UnicodeEncoding sınıfı bir UTF-16 kodlamasını temsil eder. Kodlayıcı büyük endian bayt sırasını (en önemli bayt önce) veya küçük endian bayt sırasını (önce en az önemli bayt) kullanabilir. Örneğin, Latin Büyük A Harfi (kod noktası U+0041) aşağıdaki gibi serileştirilir (onaltılık):

• Büyük endian bayt siparişi: 00 00 00 41

• Küçük endian bayt siparişi: 41 00 00 00

Unicode karakterlerini belirli bir platformun yerel bayt sırasını kullanarak depolamak genellikle daha verimlidir. Örneğin, Intel bilgisayarlar gibi küçük endian platformlarda küçük endian bayt sırasını kullanmak daha iyidir. sınıfı, UnicodeEncoding 1200 (küçük endian bayt sırası) ve 1201 (büyük endian bayt sırası) Windows kod sayfalarına karşılık gelir. yöntemini çağırarak belirli bir mimarinin "endianness" durumunu BitConverter.IsLittleEndian belirleyebilirsiniz.

İsteğe bağlı olarak, nesnesi kodlama işleminden UnicodeEncoding kaynaklanan bayt dizisine ön eklenebilen bayt dizisi olan bir bayt sırası işareti (BOM) sağlar. Ön parçada bayt sırası işareti (BOM) varsa, kod çözücüye bayt sırasını ve dönüştürme biçimini veya UTF'yi belirlemesine yardımcı olur.

UnicodeEncoding Örnek bir ürün reçetesi sağlayacak şekilde yapılandırılmışsa, yöntemini çağırarak GetPreamble alabilirsiniz; aksi takdirde yöntem boş bir dizi döndürür. Bir UnicodeEncoding nesne BOM desteği için yapılandırılsa bile, kodlanmış bayt akışının başına uygun şekilde BOM'u eklemeniz gerektiğini unutmayın; sınıfın UnicodeEncoding kodlama yöntemleri bunu otomatik olarak yapmaz.

Bayt sırası işareti (BOM) sağlamak isteyip istemediğinize, big-endian veya küçük endian kodlaması isteyip istemediğinize ve hata algılamayı etkinleştirmek isteyip istemediğinize bağlı olarak, bir UnicodeEncoding nesneyi çeşitli yollarla başlatabilirsiniz. Aşağıdaki tabloda, oluşturucular UnicodeEncoding ve Encoding nesne UnicodeEncoding döndüren özellikler listelemektedir.

GetByteCount yöntemi, bir Unicode karakter kümesinin kaç bayt ile kodlandığını belirler ve GetBytes yöntem gerçek kodlamayı gerçekleştirir.

Benzer şekilde yöntemi, GetCharCount bayt dizisinin kodunun çözülmesiyle sonuçlanan karakter sayısını belirler ve GetChars ve GetString yöntemleri gerçek kod çözme işlemini gerçekleştirir.

Birden çok blokta (100.000 karakterlik segmentlerde kodlanmış 1 milyon karakterlik dize gibi) verileri kodlarken veya kod çözerken durum bilgilerini kaydedebilen kodlayıcı veya kod çözücü için sırasıyla ve GetDecoder özelliklerini kullanınGetEncoder.

Oluşturucular

Alanlar

Özellikler

Yöntemler

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• Encoding
• Encoder
• Decoder
• UTF32Encoding
• UTF8Encoding
• UTF7Encoding
• ASCIIEncoding
• UnicodeCategory
• CharUnicodeInfo
• Kodlamaları Anlama