.NET'te karakter kodlama sınıflarını kullanma

Bu makalede, .NET'in çeşitli kodlama düzenlerini kullanarak metin kodlama ve kod çözme için sağladığı sınıfların nasıl kullanılacağı açıklanmaktadır. Yönergeler, .NET'te Karakter Kodlamaya Giriş başlıklı bölümü okuduğunuz varsayımıyla hazırlanmıştır.

Kodlayıcılar ve kod çözücüler

.NET, çeşitli kodlama sistemlerini kullanarak metin kodlayan ve kodunu çözen kodlama sınıfları sağlar. Örneğin, UTF8Encoding sınıfı UTF-8'e kodlama ve ondan kod çözme kurallarını açıklar. .NET, UTF-16 kodlaması için UnicodeEncoding sınıfını kullanır (string örnekleri için temsil edilir). Kodlayıcılar ve kod çözücüler diğer kodlama düzenleri için kullanılabilir.

Kodlama ve kod çözme de doğrulama içerebilir. Örneğin, UnicodeEncoding sınıfı geçerli vekil çiftlerde olduklarından emin olmak için vekil aralıktaki tüm char örnekleri denetler. Geri dönüş stratejisi, kodlayıcının geçersiz karakterleri nasıl işlediğini veya kod çözücülerin geçersiz baytları nasıl işlediğini belirler.

Uyarı

.NET kodlama sınıfları, karakter verilerini depolamak ve dönüştürmek için bir yol sağlar. İkili verileri dize biçiminde depolamak için kullanılmamalıdır. Kullanılan kodlamaya bağlı olarak, kodlama sınıfları ile ikili verileri dize biçimine dönüştürmek beklenmeyen davranışlara neden olabilir ve yanlış veya bozuk veriler üretebilir. İkili verileri dize formuna dönüştürmek için yöntemini kullanın Convert.ToBase64String .

.NET'teki tüm karakter kodlama sınıfları, tüm karakter kodlamaları için ortak işlevselliği tanımlayan soyut bir sınıf olan sınıfından devralır System.Text.Encoding . .NET'te uygulanan tek tek kodlama nesnelerine erişmek için aşağıdakileri yapın:

• .NET'te kullanılabilen standart karakter kodlamalarını (ASCII, UTF-7, UTF-8, UTF-16 ve UTF-32) temsil eden nesneleri döndüren sınıfın statik özelliklerini Encoding kullanın. Örneğin, Encoding.Unicode özelliği bir UnicodeEncoding nesnesi döndürür. Her nesne, kodlayamayacağı dizeleri ve kodunu çözemediği baytları işlemek için yedek geri dönüş kullanır. Daha fazla bilgi için bkz. Değiştirme yedekleme.

• Kodlamanın sınıf oluşturucusunu çağırın. ASCII, UTF-7, UTF-8, UTF-16 ve UTF-32 kodlamaları için nesneler bu şekilde örneklenebilir. Varsayılan olarak, her nesne kodlayamayacağı dizeleri ve kodunu çözemediği baytları işlemek için yedek geri dönüş kullanır, ancak bunun yerine bir özel durumun atılması gerektiğini belirtebilirsiniz. Daha fazla bilgi için, Değiştirme geri dönüşü ve Özel durum geri dönüşü bölümlerine bakın.

• Encoding(Int32) oluşturucuyu çağırın ve kodlamayı temsil eden bir tamsayı geçirerek bunu yapın. Standart kodlama nesneleri yedek geri dönüş kullanır ve kod sayfası ve çift bayt karakter kümesi (DBCS) kodlama nesneleri, kodlayamayacağı dizeleri ve kodunu çözemedikleri baytları işlemek için en uygun geri dönüşü kullanır. Daha fazla bilgi için bkz. En Uygun Yedekleme.

• Encoding.GetEncoding yöntemini çağırın, bu yöntem .NET'te mevcut olan herhangi bir standart, code page veya DBCS kodlamasını döndürür. Aşırı yüklemeler hem kodlayıcı hem de kod çözücü için bir geri dönüş nesnesi belirtmenize olanak sağlar.

yöntemini çağırarak Encoding.GetEncodings .NET'te kullanılabilen tüm kodlamalar hakkında bilgi alabilirsiniz. .NET, aşağıdaki tabloda listelenen karakter kodlama düzenlerini destekler.

Kodlama sınıfı	Açıklama
ASCII	Sınırlı bir karakter aralığını, bir baytın daha düşük yedi bitini kullanarak kodlar. Bu kodlama yalnızca U+0000 ile U+007F arası karakter değerlerini desteklediğinden, çoğu durumda uluslararası uygulamalar için yetersizdir.
UTF-7	Karakterleri 7 bit ASCII karakter dizileri olarak temsil eder. ASCII olmayan Unicode karakterler, ASCII karakterlerden oluşan bir kaçış dizisiyle temsil edilir. UTF-7, e-posta ve haber grubu gibi protokolleri destekler. Ancak UTF-7 özellikle güvenli veya sağlam değildir. Bazı durumlarda, bir biti değiştirmek utf-7 dizesinin tamamının yorumlanmasını kökten değiştirebilir. Diğer durumlarda, farklı UTF-7 dizeleri aynı metni kodlayabilir. ASCII olmayan karakterler içeren diziler için UTF-7, UTF-8'den daha fazla alan gerektirir ve kodlama/kod çözme daha yavaştır. Sonuç olarak, mümkünse UTF-7 yerine UTF-8 kullanmanız gerekir.
UTF-8	Her Unicode kod noktasını bir ile dört baytlık bir dizi olarak temsil eder. UTF-8, 8 bit veri boyutlarını destekler ve birçok mevcut işletim sistemiyle iyi çalışır. ASCII karakter aralığı için UTF-8, ASCII kodlaması ile aynıdır ve daha geniş bir karakter kümesine izin verir. Ancak, ÇinceJapanese-Korean (CJK) betikleri için UTF-8 her karakter için üç bayt gerektirebilir ve UTF-16'dan daha büyük veri boyutlarına neden olabilir. Bazen HTML etiketleri gibi ASCII veri miktarı, CJK aralığının artan boyutunu haklı olarak belirler.
UTF-16	Her Unicode kod noktasını bir veya iki 16 bit tamsayı dizisi olarak temsil eder. Unicode ek karakterleri (U+10000 ve üzeri) iki UTF-16 vekil kod noktası gerektirse de, en yaygın Unicode karakterleri yalnızca bir UTF-16 kod noktası gerektirir. Hem little-endian hem de big-endian bayt sıralamaları desteklenir. UTF-16 kodlaması, ortak dil çalışma zamanı tarafından Char ve String değerlerini temsil etmek için, Windows işletim sistemi tarafından ise WCHAR değerlerini göstermek için kullanılır.
UTF-32	Her Unicode kod noktasını 32 bit tamsayı olarak temsil eder. Hem little-endian hem de big-endian bayt sıralamaları desteklenir. UTF-32 kodlaması, uygulamalar kodlanmış alanın çok önemli olduğu işletim sistemlerinde UTF-16 kodlamasının vekil kod noktası davranışından kaçınmak istediğinde kullanılır. Bir ekranda işlenen tek glifler yine de birden fazla UTF-32 karakteriyle kodlanabilir.
ANSI/ISO kodlaması	Çeşitli kod sayfaları için destek sağlar. Windows işletim sistemlerinde kod sayfaları belirli bir dili veya dil grubunu desteklemek için kullanılır. .NET tarafından desteklenen kod sayfalarını listeleyen bir tablo için Encoding sınıfına bakın. yöntemini çağırarak Encoding.GetEncoding(Int32) belirli bir kod sayfası için kodlama nesnesi alabilirsiniz. Kod sayfası 256 kod noktası içerir ve sıfır tabanlıdır. Çoğu kod sayfasında 0 ile 127 arasındaki kod noktaları ASCII karakter kümesini temsil ve 128 ile 255 arasındaki kod noktaları kod sayfaları arasında önemli ölçüde farklılık gösterir. Örneğin, 1252 kod sayfası İngilizce, Almanca ve Fransızca dahil olmak üzere Latin yazma sistemlerinin karakterlerini sağlar. 1252 kod sayfasındaki son 128 kod noktası vurgu karakterlerini içerir. Kod sayfası 1253 Yunanca yazma sisteminde gerekli karakter kodları sağlar. Kod sayfası 1253'teki son 128 kod noktası Yunanca karakterleri içerir. Sonuç olarak, ANSI kod sayfalarını kullanan bir uygulama, başvurulan kod sayfasını belirten bir tanımlayıcı içermediği sürece Yunanca ve Almanca'yı aynı metin akışında depolayamaz.
Çift baytlık karakter kümesi (DBCS) kodlamaları	256'dan fazla karakter içeren Çince, Japonca ve Korece gibi dilleri destekler. DBCS'de bir çift kod noktası (çift bayt) her karakteri temsil eder. Encoding.IsSingleByte özelliği DBCS kodlamaları için döndürürfalse. yöntemini çağırarak Encoding.GetEncoding(Int32) belirli bir DBCS için kodlama nesnesi alabilirsiniz. Bir uygulama DBCS verilerini işlerken, bir DBCS karakterinin ilk baytı (ön bayt), hemen ardından gelen iz baytı ile birlikte işlenir. Tek çift baytlı kod noktası çifti kod sayfasına bağlı olarak farklı karakterleri temsil ettiğinden, bu düzen yine de aynı veri akışında Japonca ve Çince gibi iki dilin birleşimine izin vermez.

Bu kodlamalar, Unicode karakterlerle ve eski uygulamalarda en yaygın olarak kullanılan kodlamalarla çalışmanızı sağlar. Ayrıca, Encoding türeten bir sınıf tanımlayıp üyelerini geçersiz kılarak özel bir kodlama oluşturabilirsiniz.

.NET Core kodlama desteği

Varsayılan olarak, .NET Core 28591 kod sayfası ve UTF-8 ve UTF-16 gibi Unicode kodlamaları dışındaki kod sayfası kodlamalarını kullanıma sunmaz. Ancak, .NET'i hedefleyen standart Windows uygulamalarında bulunan kod sayfası kodlamalarını uygulamanıza ekleyebilirsiniz. Daha fazla bilgi için CodePagesEncodingProvider konusuna bakın.

Kodlama Sınıfı Seçme

Uygulamanız tarafından kullanılacak kodlamayı seçme fırsatınız varsa, tercihen UTF8Encoding veya UnicodeEncodingbir Unicode kodlaması kullanmalısınız. (.NET, UTF32Encoding adlı üçüncü bir Unicode kodlamasını da destekler.)

ASCII kodlaması ASCIIEncoding kullanmayı planlıyorsanız, bunun yerine UTF8Encoding öğesini seçin. İki kodlama ASCII karakter kümesi için aynıdır, ancak UTF8Encoding aşağıdaki avantajlara sahiptir:

• Her Unicode karakterini temsil edebilir, fakat ASCIIEncoding yalnızca U+0000 ile U+007F arasındaki Unicode karakter değerlerini destekler.

• Hata algılama ve daha iyi güvenlik sağlar.

• Mümkün olduğunca hızlı olacak şekilde ayarlanmıştır ve diğer kodlamalardan daha hızlı olmalıdır. Tamamen ASCII olan içerik için bile ile UTF8Encoding gerçekleştirilen işlemler ile ASCIIEncodinggerçekleştirilen işlemlerden daha hızlıdır.

ASCIIEncoding yalnızca eski uygulamalar için kullanmayı düşünmelisiniz. Ancak, eski uygulamalar UTF8Encoding için bile, aşağıdaki nedenlerle (varsayılan ayarları varsayarak) daha iyi bir seçim olabilir:

• Uygulamanız kesinlikle ASCII olmayan içeriğe sahipse ve ile kodlarsa ASCIIEncoding, ASCII olmayan her karakter bir soru işareti (?) olarak kodlar. Uygulama daha sonra bu verilerin kodunu çözerse, bilgiler kaybolur.

• Uygulamanız ASCII olmayan içeriği UTF8Encoding ile kodluyorsa, bu içerik ASCII olarak yorumlandığında anlaşılmaz görünebilir. Ancak uygulama daha sonra bu verilerin kodunu çözmek için UTF-8 kod çözücüsü kullanırsa, veriler başarıyla gidiş dönüş gerçekleştirir.

Bir web uygulamasında, bir web isteğine yanıt olarak istemciye gönderilen karakterler istemcide kullanılan kodlamayı yansıtmalıdır. Çoğu durumda, kullanıcının beklediği kodlamada metni görüntülemek için HttpResponse.ContentEncoding özelliğini, HttpRequest.ContentEncoding özelliği tarafından döndürülen değere ayarlamanız gerekir.

Kodlama Nesnesi Kullanma

Kodlayıcı, bir karakter dizesini (en yaygın olarak Unicode karakterleri) sayısal (bayt) eşdeğerine dönüştürür. Örneğin, Unicode karakterleri konsolda görüntülenebilmeleri için ASCII'ye dönüştürmek için bir ASCII kodlayıcı kullanabilirsiniz. Dönüştürmeyi gerçekleştirmek için yöntemini çağırırsınız Encoding.GetBytes . Kodlamayı gerçekleştirmeden önce kodlanmış karakterleri depolamak için kaç bayt gerektiğini belirlemek istiyorsanız yöntemini çağırabilirsiniz GetByteCount .

Aşağıdaki örnek, dizeleri iki ayrı işlemde kodlamak için tek bir bayt dizisi kullanır. Sonraki ASCII ile kodlanmış bayt kümesi için bayt dizisindeki başlangıç konumunu gösteren bir dizin tutar. Bayt dizisinin ASCIIEncoding.GetByteCount(String) kodlanmış dizeyi barındıracak kadar büyük olduğundan emin olmak için yöntemini çağırır. Ardından dizedeki ASCIIEncoding.GetBytes(String, Int32, Int32, Byte[], Int32) karakterleri kodlamak için yöntemini çağırır.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      string[] strings= { "This is the first sentence. ",
                          "This is the second sentence. " };
      Encoding asciiEncoding = Encoding.ASCII;

      // Create array of adequate size.
      byte[] bytes = new byte[49];
      // Create index for current position of array.
      int index = 0;

      Console.WriteLine("Strings to encode:");
      foreach (var stringValue in strings) {
         Console.WriteLine($"   {stringValue}");

         int count = asciiEncoding.GetByteCount(stringValue);
         if (count + index >=  bytes.Length)
            Array.Resize(ref bytes, bytes.Length + 50);

         int written = asciiEncoding.GetBytes(stringValue, 0,
                                              stringValue.Length,
                                              bytes, index);

         index = index + written;
      }
      Console.WriteLine("\nEncoded bytes:");
      Console.WriteLine($"{ShowByteValues(bytes, index)}");
      Console.WriteLine();

      // Decode Unicode byte array to a string.
      string newString = asciiEncoding.GetString(bytes, 0, index);
      Console.WriteLine($"Decoded: {newString}");
   }

   private static string ShowByteValues(byte[] bytes, int last )
   {
      string returnString = "   ";
      for (int ctr = 0; ctr <= last - 1; ctr++) {
         if (ctr % 20 == 0)
            returnString += "\n   ";
         returnString += String.Format("{0:X2} ", bytes[ctr]);
      }
      return returnString;
   }
}
// The example displays the following output:
//       Strings to encode:
//          This is the first sentence.
//          This is the second sentence.
//
//       Encoded bytes:
//
//          54 68 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 73 65
//          6E 74 65 6E 63 65 2E 20 54 68 69 73 20 69 73 20 74 68 65 20
//          73 65 63 6F 6E 64 20 73 65 6E 74 65 6E 63 65 2E 20
//
//       Decoded: This is the first sentence. This is the second sentence.

Imports System.Text

Module Example
    Public Sub Main()
        Dim strings() As String = {"This is the first sentence. ",
                                    "This is the second sentence. "}
        Dim asciiEncoding As Encoding = Encoding.ASCII

        ' Create array of adequate size.
        Dim bytes(50) As Byte
        ' Create index for current position of array.
        Dim index As Integer = 0

        Console.WriteLine("Strings to encode:")
        For Each stringValue In strings
            Console.WriteLine("   {0}", stringValue)

            Dim count As Integer = asciiEncoding.GetByteCount(stringValue)
            If count + index >= bytes.Length Then
                Array.Resize(bytes, bytes.Length + 50)
            End If
            Dim written As Integer = asciiEncoding.GetBytes(stringValue, 0,
                                                            stringValue.Length,
                                                            bytes, index)

            index = index + written
        Next
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Console.WriteLine("{0}", ShowByteValues(bytes, index))
        Console.WriteLine()

        ' Decode Unicode byte array to a string.
        Dim newString As String = asciiEncoding.GetString(bytes, 0, index)
        Console.WriteLine("Decoded: {0}", newString)
    End Sub

    Private Function ShowByteValues(bytes As Byte(), last As Integer) As String
        Dim returnString As String = "   "
        For ctr As Integer = 0 To last - 1
            If ctr Mod 20 = 0 Then returnString += vbCrLf + "   "
            returnString += String.Format("{0:X2} ", bytes(ctr))
        Next
        Return returnString
    End Function
End Module
' The example displays the following output:
'       Strings to encode:
'          This is the first sentence.
'          This is the second sentence.
'       
'       Encoded bytes:
'       
'          54 68 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 73 65
'          6E 74 65 6E 63 65 2E 20 54 68 69 73 20 69 73 20 74 68 65 20
'          73 65 63 6F 6E 64 20 73 65 6E 74 65 6E 63 65 2E 20
'       
'       Decoded: This is the first sentence. This is the second sentence.

Kod çözücü, belirli bir karakter kodlamayı yansıtan bayt dizisini, karakter dizisindeki veya dizedeki bir karakter kümesine dönüştürür. Bayt dizisinin kodunu karakter dizisine çözmek için yöntemini çağırırsınız Encoding.GetChars . Bayt dizisini bir dizeye decode etmek için GetString yöntemini çağırırsınız. Kod çözme işlemini gerçekleştirmeden önce kodu çözülen baytları depolamak için kaç karakter gerektiğini belirlemek istiyorsanız yöntemini çağırabilirsiniz GetCharCount .

Aşağıdaki örnek üç dizeyi kodlar ve sonra bunları tek bir karakter dizisi olarak çözer. Kodu çözülen bir sonraki karakter kümesi için karakter dizisindeki başlangıç konumunu gösteren bir dizin tutar. Karakter dizisinin çözülen tüm karakterleri barındıracak kadar büyük olup olmadığını kontrol etmek için GetCharCount yöntemini çağırır. Ardından bayt dizisinin ASCIIEncoding.GetChars(Byte[], Int32, Int32, Char[], Int32) kodunu çözmek için yöntemini çağırır.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      string[] strings = { "This is the first sentence. ",
                           "This is the second sentence. ",
                           "This is the third sentence. " };
      Encoding asciiEncoding = Encoding.ASCII;
      // Array to hold encoded bytes.
      byte[] bytes;
      // Array to hold decoded characters.
      char[] chars = new char[50];
      // Create index for current position of character array.
      int index = 0;

      foreach (var stringValue in strings) {
         Console.WriteLine($"String to Encode: {stringValue}");
         // Encode the string to a byte array.
         bytes = asciiEncoding.GetBytes(stringValue);
         // Display the encoded bytes.
         Console.Write("Encoded bytes: ");
         for (int ctr = 0; ctr < bytes.Length; ctr++)
            Console.Write(" {0}{1:X2}",
                          ctr % 20 == 0 ? Environment.NewLine : "",
                          bytes[ctr]);
         Console.WriteLine();

         // Decode the bytes to a single character array.
         int count = asciiEncoding.GetCharCount(bytes);
         if (count + index >=  chars.Length)
            Array.Resize(ref chars, chars.Length + 50);

         int written = asciiEncoding.GetChars(bytes, 0,
                                              bytes.Length,
                                              chars, index);
         index = index + written;
         Console.WriteLine();
      }

      // Instantiate a single string containing the characters.
      string decodedString = new string(chars, 0, index - 1);
      Console.WriteLine("Decoded string: ");
      Console.WriteLine(decodedString);
   }
}
// The example displays the following output:
//    String to Encode: This is the first sentence.
//    Encoded bytes:
//    54 68 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 73 65
//    6E 74 65 6E 63 65 2E 20
//
//    String to Encode: This is the second sentence.
//    Encoded bytes:
//    54 68 69 73 20 69 73 20 74 68 65 20 73 65 63 6F 6E 64 20 73
//    65 6E 74 65 6E 63 65 2E 20
//
//    String to Encode: This is the third sentence.
//    Encoded bytes:
//    54 68 69 73 20 69 73 20 74 68 65 20 74 68 69 72 64 20 73 65
//    6E 74 65 6E 63 65 2E 20
//
//    Decoded string:
//    This is the first sentence. This is the second sentence. This is the third sentence.

Imports System.Text

Module Example
    Public Sub Main()
        Dim strings() As String = {"This is the first sentence. ",
                                    "This is the second sentence. ",
                                    "This is the third sentence. "}
        Dim asciiEncoding As Encoding = Encoding.ASCII
        ' Array to hold encoded bytes.
        Dim bytes() As Byte
        ' Array to hold decoded characters.
        Dim chars(50) As Char
        ' Create index for current position of character array.
        Dim index As Integer

        For Each stringValue In strings
            Console.WriteLine("String to Encode: {0}", stringValue)
            ' Encode the string to a byte array.
            bytes = asciiEncoding.GetBytes(stringValue)
            ' Display the encoded bytes.
            Console.Write("Encoded bytes: ")
            For ctr As Integer = 0 To bytes.Length - 1
                Console.Write(" {0}{1:X2}", If(ctr Mod 20 = 0, vbCrLf, ""),
                                            bytes(ctr))
            Next
            Console.WriteLine()

            ' Decode the bytes to a single character array.
            Dim count As Integer = asciiEncoding.GetCharCount(bytes)
            If count + index >= chars.Length Then
                Array.Resize(chars, chars.Length + 50)
            End If
            Dim written As Integer = asciiEncoding.GetChars(bytes, 0,
                                                            bytes.Length,
                                                            chars, index)
            index = index + written
            Console.WriteLine()
        Next

        ' Instantiate a single string containing the characters.
        Dim decodedString As New String(chars, 0, index - 1)
        Console.WriteLine("Decoded string: ")
        Console.WriteLine(decodedString)
    End Sub
End Module
' The example displays the following output:
'    String to Encode: This is the first sentence.
'    Encoded bytes:
'    54 68 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 73 65
'    6E 74 65 6E 63 65 2E 20
'    
'    String to Encode: This is the second sentence.
'    Encoded bytes:
'    54 68 69 73 20 69 73 20 74 68 65 20 73 65 63 6F 6E 64 20 73
'    65 6E 74 65 6E 63 65 2E 20
'    
'    String to Encode: This is the third sentence.
'    Encoded bytes:
'    54 68 69 73 20 69 73 20 74 68 65 20 74 68 69 72 64 20 73 65
'    6E 74 65 6E 63 65 2E 20
'    
'    Decoded string:
'    This is the first sentence. This is the second sentence. This is the third sentence.

öğesinden Encoding türetilen bir sınıfın kodlama ve kod çözme yöntemleri, tam bir veri kümesi üzerinde çalışacak şekilde tasarlanmıştır; yani kodlanacak veya kodu çözülecek tüm veriler tek bir yöntem çağrısında sağlanır. Ancak bazı durumlarda veriler bir akışta kullanılabilir ve kodlanacak veya çözülecek veriler yalnızca ayrı okuma işlemlerinden kullanılabilir. Bunun için kodlama veya kod çözme işleminin önceki çağrısından kaydedilmiş durumları anımsaması gerekir. Encoder ve Decoder sınıflarından türetilen sınıfların yöntemleri, birden çok yöntem çağrısını kapsayan kodlama ve kod çözme işlemlerini gerçekleştirebilir.

Encoder Belirli bir kodlamaya yönelik bir nesne, bu kodlamanın Encoding.GetEncoder() özelliğinden kullanılabilir. Decoder Belirli bir kodlamaya yönelik bir nesne, bu kodlamanın Encoding.GetDecoder() özelliğinden kullanılabilir. Kod çözme işlemleri için, Decoder türetilen sınıfların bir Decoder.GetChars yöntemi içerdiğini, ancak Encoding.GetString ile karşılık gelen bir yöntemleri olmadığını unutmayın.

Aşağıdaki örnekte, unicode bayt dizisinin Encoding.GetString kodunu çözmek için ve Decoder.GetChars yöntemlerinin kullanılması arasındaki fark gösterilmektedir. Örnek, bir dosyaya bazı Unicode karakterleri içeren bir dizeyi kodlar ve sonra her seferinde on bayt kodunu çözmek için iki kod çözme yöntemini kullanır. Onuncu ve on birinci baytlarda surrojet çift oluştuğundan, ayrı yöntem çağrılarıyla çözülür. Çıktıda gösterildiği gibi, Encoding.GetString yöntemi baytların kodunu doğru şekilde çözemez ve bunun yerine U+FFFD (Değiştirme Karakteri) ile değiştirir. Öte yandan, Decoder.GetChars yöntemi bayt dizisini çözümleyerek özgün dizeyi başarıyla elde edebildi.

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

public class Example
{
   public static void Main()
   {
      // Use default replacement fallback for invalid encoding.
      UnicodeEncoding enc = new UnicodeEncoding(true, false, false);

      // Define a string with various Unicode characters.
      string str1 = "AB YZ 19 \uD800\udc05 \u00e4";
      str1 += "Unicode characters. \u00a9 \u010C s \u0062\u0308";
      Console.WriteLine("Created original string...\n");

      // Convert string to byte array.
      byte[] bytes = enc.GetBytes(str1);

      FileStream fs = File.Create(@".\characters.bin");
      BinaryWriter bw = new BinaryWriter(fs);
      bw.Write(bytes);
      bw.Close();

      // Read bytes from file.
      FileStream fsIn = File.OpenRead(@".\characters.bin");
      BinaryReader br = new BinaryReader(fsIn);

      const int count = 10;            // Number of bytes to read at a time.
      byte[] bytesRead = new byte[10]; // Buffer (byte array).
      int read;                        // Number of bytes actually read.
      string str2 = String.Empty;      // Decoded string.

      // Try using Encoding object for all operations.
      do {
         read = br.Read(bytesRead, 0, count);
         str2 += enc.GetString(bytesRead, 0, read);
      } while (read == count);
      br.Close();
      Console.WriteLine("Decoded string using UnicodeEncoding.GetString()...");
      CompareForEquality(str1, str2);
      Console.WriteLine();

      // Use Decoder for all operations.
      fsIn = File.OpenRead(@".\characters.bin");
      br = new BinaryReader(fsIn);
      Decoder decoder = enc.GetDecoder();
      char[] chars = new char[50];
      int index = 0;                   // Next character to write in array.
      int written = 0;                 // Number of chars written to array.
      do {
         read = br.Read(bytesRead, 0, count);
         if (index + decoder.GetCharCount(bytesRead, 0, read) - 1 >= chars.Length)
            Array.Resize(ref chars, chars.Length + 50);

         written = decoder.GetChars(bytesRead, 0, read, chars, index);
         index += written;
      } while (read == count);
      br.Close();
      // Instantiate a string with the decoded characters.
      string str3 = new String(chars, 0, index);
      Console.WriteLine("Decoded string using UnicodeEncoding.Decoder.GetString()...");
      CompareForEquality(str1, str3);
   }

   private static void CompareForEquality(string original, string decoded)
   {
      bool result = original.Equals(decoded);
      Console.WriteLine($"original = decoded: {original.Equals(decoded, StringComparison.Ordinal)}");
      if (! result) {
         Console.WriteLine("Code points in original string:");
         foreach (var ch in original)
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
         Console.WriteLine();

         Console.WriteLine("Code points in decoded string:");
         foreach (var ch in decoded)
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//    Created original string...
//
//    Decoded string using UnicodeEncoding.GetString()...
//    original = decoded: False
//    Code points in original string:
//    0041 0042 0020 0059 005A 0020 0031 0039 0020 D800 DC05 0020 00E4 0055 006E 0069 0063 006F
//    0064 0065 0020 0063 0068 0061 0072 0061 0063 0074 0065 0072 0073 002E 0020 00A9 0020 010C
//    0020 0073 0020 0062 0308
//    Code points in decoded string:
//    0041 0042 0020 0059 005A 0020 0031 0039 0020 FFFD FFFD 0020 00E4 0055 006E 0069 0063 006F
//    0064 0065 0020 0063 0068 0061 0072 0061 0063 0074 0065 0072 0073 002E 0020 00A9 0020 010C
//    0020 0073 0020 0062 0308
//
//    Decoded string using UnicodeEncoding.Decoder.GetString()...
//    original = decoded: True

Imports System.IO
Imports System.Text

Module Example
    Public Sub Main()
        ' Use default replacement fallback for invalid encoding.
        Dim enc As New UnicodeEncoding(True, False, False)

        ' Define a string with various Unicode characters.
        Dim str1 As String = String.Format("AB YZ 19 {0}{1} {2}",
                                           ChrW(&hD800), ChrW(&hDC05), ChrW(&h00e4))
        str1 += String.Format("Unicode characters. {0} {1} s {2}{3}",
                              ChrW(&h00a9), ChrW(&h010C), ChrW(&h0062), ChrW(&h0308))
        Console.WriteLine("Created original string...")
        Console.WriteLine()

        ' Convert string to byte array.                     
        Dim bytes() As Byte = enc.GetBytes(str1)

        Dim fs As FileStream = File.Create(".\characters.bin")
        Dim bw As New BinaryWriter(fs)
        bw.Write(bytes)
        bw.Close()

        ' Read bytes from file.
        Dim fsIn As FileStream = File.OpenRead(".\characters.bin")
        Dim br As New BinaryReader(fsIn)

        Const count As Integer = 10      ' Number of bytes to read at a time. 
        Dim bytesRead(9) As Byte         ' Buffer (byte array).
        Dim read As Integer              ' Number of bytes actually read. 
        Dim str2 As String = ""          ' Decoded string.

        ' Try using Encoding object for all operations.
        Do
            read = br.Read(bytesRead, 0, count)
            str2 += enc.GetString(bytesRead, 0, read)
        Loop While read = count
        br.Close()
        Console.WriteLine("Decoded string using UnicodeEncoding.GetString()...")
        CompareForEquality(str1, str2)
        Console.WriteLine()

        ' Use Decoder for all operations.
        fsIn = File.OpenRead(".\characters.bin")
        br = New BinaryReader(fsIn)
        Dim decoder As Decoder = enc.GetDecoder()
        Dim chars(50) As Char
        Dim index As Integer = 0         ' Next character to write in array.
        Dim written As Integer = 0       ' Number of chars written to array.
        Do
            read = br.Read(bytesRead, 0, count)
            If index + decoder.GetCharCount(bytesRead, 0, read) - 1 >= chars.Length Then
                Array.Resize(chars, chars.Length + 50)
            End If
            written = decoder.GetChars(bytesRead, 0, read, chars, index)
            index += written
        Loop While read = count
        br.Close()
        ' Instantiate a string with the decoded characters.
        Dim str3 As New String(chars, 0, index)
        Console.WriteLine("Decoded string using UnicodeEncoding.Decoder.GetString()...")
        CompareForEquality(str1, str3)
    End Sub

    Private Sub CompareForEquality(original As String, decoded As String)
        Dim result As Boolean = original.Equals(decoded)
        Console.WriteLine("original = decoded: {0}",
                          original.Equals(decoded, StringComparison.Ordinal))
        If Not result Then
            Console.WriteLine("Code points in original string:")
            For Each ch In original
                Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
            Next
            Console.WriteLine()

            Console.WriteLine("Code points in decoded string:")
            For Each ch In decoded
                Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
            Next
            Console.WriteLine()
        End If
    End Sub
End Module
' The example displays the following output:
'    Created original string...
'    
'    Decoded string using UnicodeEncoding.GetString()...
'    original = decoded: False
'    Code points in original string:
'    0041 0042 0020 0059 005A 0020 0031 0039 0020 D800 DC05 0020 00E4 0055 006E 0069 0063 006F
'    0064 0065 0020 0063 0068 0061 0072 0061 0063 0074 0065 0072 0073 002E 0020 00A9 0020 010C
'    0020 0073 0020 0062 0308
'    Code points in decoded string:
'    0041 0042 0020 0059 005A 0020 0031 0039 0020 FFFD FFFD 0020 00E4 0055 006E 0069 0063 006F
'    0064 0065 0020 0063 0068 0061 0072 0061 0063 0074 0065 0072 0073 002E 0020 00A9 0020 010C
'    0020 0073 0020 0062 0308
'    
'    Decoded string using UnicodeEncoding.Decoder.GetString()...
'    original = decoded: True

Geri Dönüş Stratejisi Seçme

Bir yöntem bir karakteri kodlamaya veya kodunu çözmeye çalıştığında ancak eşleme olmadığında, başarısız eşlemenin nasıl işleneceğini belirleyen bir geri dönüş stratejisi uygulamalıdır. Üç tür geri dönüş stratejisi vardır:

• En uygun yedek çözüm

• Yedek seçenek

• İstisna yedeği

Önemli

Kodlama işlemlerinde en yaygın sorunlar, bir Unicode karakteri belirli bir kod sayfası kodlamasına eşlenemediğinde oluşur. Kod çözme işlemlerinde en yaygın sorunlar, geçersiz bayt dizileri geçerli Unicode karakterlerine çevrilemediğinde oluşur. Bu nedenlerden dolayı, belirli bir kodlama nesnesinin hangi geri dönüş stratejisini kullandığını bilmeniz gerekir. Mümkün olduğunda, bir kodlama nesnesinin örneğini oluştururken kullanılan geri dönüş stratejisini belirtmelisiniz.

Best-Fit Geri Dönüş

Bir karakterin hedef kodlamada tam eşleşmesi olmadığında kodlayıcı bunu benzer bir karakterle eşlemeyi deneyebilir. En uygun geri dönüş, kod çözme sorunu yerine çoğunlukla bir kodlama sorunudur. Unicode ile başarıyla eşlenemeyen karakterler içeren çok az kod sayfası vardır. En uygun geri dönüş, Encoding.GetEncoding(Int32) ve Encoding.GetEncoding(String) aşırı yüklemeleri tarafından alınan kod sayfası ve çift baytlık karakter kümesi kodlamaları için varsayılan değerdir.

Uyarı

Teoride, .NET 'te (UTF8Encoding, UnicodeEncodingve UTF32Encoding) sağlanan Unicode kodlama sınıfları her karakter kümesindeki her karakteri destekler, böylece en uygun geri dönüş sorunlarını ortadan kaldırmak için kullanılabilirler.

En uygun stratejiler farklı kod sayfaları için farklılık gösterir. Örneğin, bazı kod sayfalarında tam genişlikli Latin karakterler, daha yaygın olan yarım genişlikli Latin karakterlere eşlenir. Diğer kod sayfaları için bu eşleme yapılmaz. Agresif bir en iyi uyum stratejisi altında bile, bazı kodlamalardaki bazı karakterler için mümkün olan bir uyum yoktur. Örneğin, Çince bir ideografın 1252 kod sayfasıyla makul eşlemesi yoktur. Bu durumda, bir değiştirme dizesi kullanılır. Varsayılan olarak, bu dize yalnızca tek bir SORU İşaretİdir (U+003F).

Uyarı

En uygun stratejiler ayrıntılı olarak belgelenmez. Ancak, Unicode Konsorsiyumu'nun web sitesinde birkaç kod sayfası belgelenmiştir. Eşleme dosyalarının nasıl yorumlandığının açıklaması için lütfen bu klasördeki readme.txt dosyasını gözden geçirin.

Aşağıdaki örnek, en uygun eşlemeyi ve dezavantajlarını göstermek için 1252 kod sayfasını (Batı Avrupa dilleri için Windows kod sayfası) kullanır. Encoding.GetEncoding(Int32) yöntemi, kod sayfası 1252 için bir kodlama nesnesi elde etmek amacıyla kullanılır. Varsayılan olarak, desteklemediği Unicode karakterleri için en uygun eşlemeyi kullanır. Örnek, ASCII olmayan üç karakter içeren bir dizenin örneğini oluşturur: DAIRE IÇINE ALıNMıŞ LATIN BÜYÜK HARF S (U+24C8), ÜST SIMGE BEŞ (U+2075) ve SONSUZLUK (U+221E) - boşluklarla ayrılmış. Örnekteki çıktıda gösterildiği gibi, dize kodlandığında, üç orijinal boşluk olmayan karakterin yerini SORU İŞARETİ (U+003F), RAKAM BEŞ (U+0035) ve RAKAM SEKİZ (U+0038) alır. RAKAM SEKİZ, desteklenmeyen INFINITY karakteri için özellikle kötü bir değişimdir ve SORU İŞARETİ orijinal karakter için bir eşleme bulunmadığını gösterir.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      // Get an encoding for code page 1252 (Western Europe character set).
      Encoding cp1252 = Encoding.GetEncoding(1252);

      // Define and display a string.
      string str = "\u24c8 \u2075 \u221e";
      Console.WriteLine("Original string: " + str);
      Console.Write("Code points in string: ");
      foreach (var ch in str)
         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));

      Console.WriteLine("\n");

      // Encode a Unicode string.
      Byte[] bytes = cp1252.GetBytes(str);
      Console.Write("Encoded bytes: ");
      foreach (byte byt in bytes)
         Console.Write("{0:X2} ", byt);
      Console.WriteLine("\n");

      // Decode the string.
      string str2 = cp1252.GetString(bytes);
      Console.WriteLine($"String round-tripped: {str.Equals(str2)}");
      if (! str.Equals(str2)) {
         Console.WriteLine(str2);
         foreach (var ch in str2)
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
      }
   }
}
// The example displays the following output:
//       Original string: Ⓢ ⁵ ∞
//       Code points in string: 24C8 0020 2075 0020 221E
//
//       Encoded bytes: 3F 20 35 20 38
//
//       String round-tripped: False
//       ? 5 8
//       003F 0020 0035 0020 0038

Imports System.Text

Module Example
    Public Sub Main()
        ' Get an encoding for code page 1252 (Western Europe character set).
        Dim cp1252 As Encoding = Encoding.GetEncoding(1252)

        ' Define and display a string.
        Dim str As String = String.Format("{0} {1} {2}", ChrW(&h24c8), ChrW(&H2075), ChrW(&h221E))
        Console.WriteLine("Original string: " + str)
        Console.Write("Code points in string: ")
        For Each ch In str
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
        Next
        Console.WriteLine()
        Console.WriteLine()

        ' Encode a Unicode string.
        Dim bytes() As Byte = cp1252.GetBytes(str)
        Console.Write("Encoded bytes: ")
        For Each byt In bytes
            Console.Write("{0:X2} ", byt)
        Next
        Console.WriteLine()
        Console.WriteLine()

        ' Decode the string.
        Dim str2 As String = cp1252.GetString(bytes)
        Console.WriteLine("String round-tripped: {0}", str.Equals(str2))
        If Not str.Equals(str2) Then
            Console.WriteLine(str2)
            For Each ch In str2
                Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
            Next
        End If
    End Sub
End Module
' The example displays the following output:
'       Original string: Ⓢ ⁵ ∞
'       Code points in string: 24C8 0020 2075 0020 221E
'       
'       Encoded bytes: 3F 20 35 20 38
'       
'       String round-tripped: False
'       ? 5 8
'       003F 0020 0035 0020 0038

En iyi eşleme, Unicode verilerini kod sayfası verilerine kodlayan bir Encoding nesnesi için varsayılan davranıştır ve bu davranışa dayanan eski uygulamalar vardır. Ancak, çoğu yeni uygulama güvenlik nedeniyle en uygun davranıştan kaçınmalıdır. Örneğin, uygulamalar en uygun kodlama aracılığıyla bir etki alanı adı koymamalıdır.

Uyarı

Ayrıca, kodlama için özel bir en uygun geri dönüş eşlemesi de uygulayabilirsiniz. Daha fazla bilgi için Özel Geri Dönüş Stratejisini Uygulama bölümüne bakın.

Kodlama nesnesi için en uygun geri dönüş varsayılan değerse, Encoding veya Encoding.GetEncoding(Int32, EncoderFallback, DecoderFallback) aşırı yüklemesini çağırarak bir Encoding.GetEncoding(String, EncoderFallback, DecoderFallback) nesnesi aldığınızda başka bir geriye dönüş stratejisi seçebilirsiniz. Aşağıdaki bölüm, 1252 kod sayfasına eşlenemeyen her karakteri yıldız (*) ile değiştiren bir örnek içerir.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      Encoding cp1252r = Encoding.GetEncoding(1252,
                                  new EncoderReplacementFallback("*"),
                                  new DecoderReplacementFallback("*"));

      string str1 = "\u24C8 \u2075 \u221E";
      Console.WriteLine(str1);
      foreach (var ch in str1)
         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));

      Console.WriteLine();

      byte[] bytes = cp1252r.GetBytes(str1);
      string str2 = cp1252r.GetString(bytes);
      Console.WriteLine($"Round-trip: {str1.Equals(str2)}");
      if (! str1.Equals(str2)) {
         Console.WriteLine(str2);
         foreach (var ch in str2)
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       Ⓢ ⁵ ∞
//       24C8 0020 2075 0020 221E
//       Round-trip: False
//       * * *
//       002A 0020 002A 0020 002A

Imports System.Text

Module Example
    Public Sub Main()
        Dim cp1252r As Encoding = Encoding.GetEncoding(1252,
                                           New EncoderReplacementFallback("*"),
                                           New DecoderReplacementFallback("*"))

        Dim str1 As String = String.Format("{0} {1} {2}", ChrW(&h24C8), ChrW(&h2075), ChrW(&h221E))
        Console.WriteLine(str1)
        For Each ch In str1
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
        Next
        Console.WriteLine()

        Dim bytes() As Byte = cp1252r.GetBytes(str1)
        Dim str2 As String = cp1252r.GetString(bytes)
        Console.WriteLine("Round-trip: {0}", str1.Equals(str2))
        If Not str1.Equals(str2) Then
            Console.WriteLine(str2)
            For Each ch In str2
                Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
            Next
            Console.WriteLine()
        End If
    End Sub
End Module
' The example displays the following output:
'       Ⓢ ⁵ ∞
'       24C8 0020 2075 0020 221E
'       Round-trip: False
'       * * *
'       002A 0020 002A 0020 002A

Alternatif Çözüm

Bir karakterin hedef düzende tam eşleşmesi yoksa, ancak eşlenebileceği uygun bir karakter yoksa, uygulama yeni bir karakter veya dize belirtebilir. Bu, kodunu çözemediği iki baytlık diziyi REPLACEMENT_CHARACTER (U+FFFD) ile değiştiren Unicode kod çözücü için varsayılan davranıştır. Ayrıca sınıfın ASCIIEncoding varsayılan davranışıdır ve kodlayamadığı veya kodunu çözemediği her karakteri bir soru işaretiyle değiştirir. Aşağıdaki örnekte, önceki örnekteki Unicode dizesinin karakter değişimi gösterilmektedir. Çıktıda gösterildiği gibi, ASCII bayt değerine çözülemeyen her karakter, soru işaretinin ASCII kodu olan 0x3F ile değiştirilir.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      Encoding enc = Encoding.ASCII;

      string str1 = "\u24C8 \u2075 \u221E";
      Console.WriteLine(str1);
      foreach (var ch in str1)
         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));

      Console.WriteLine("\n");

      // Encode the original string using the ASCII encoder.
      byte[] bytes = enc.GetBytes(str1);
      Console.Write("Encoded bytes: ");
      foreach (var byt in bytes)
         Console.Write("{0:X2} ", byt);
      Console.WriteLine("\n");

      // Decode the ASCII bytes.
      string str2 = enc.GetString(bytes);
      Console.WriteLine($"Round-trip: {str1.Equals(str2)}");
      if (! str1.Equals(str2)) {
         Console.WriteLine(str2);
         foreach (var ch in str2)
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       Ⓢ ⁵ ∞
//       24C8 0020 2075 0020 221E
//
//       Encoded bytes: 3F 20 3F 20 3F
//
//       Round-trip: False
//       ? ? ?
//       003F 0020 003F 0020 003F

Imports System.Text

Module Example
    Public Sub Main()
        Dim enc As Encoding = Encoding.Ascii

        Dim str1 As String = String.Format("{0} {1} {2}", ChrW(&h24C8), ChrW(&h2075), ChrW(&h221E))
        Console.WriteLine(str1)
        For Each ch In str1
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
        Next
        Console.WriteLine()
        Console.WriteLine()

        ' Encode the original string using the ASCII encoder.
        Dim bytes() As Byte = enc.GetBytes(str1)
        Console.Write("Encoded bytes: ")
        For Each byt In bytes
            Console.Write("{0:X2} ", byt)
        Next
        Console.WriteLine()
        Console.WriteLine()

        ' Decode the ASCII bytes.
        Dim str2 As String = enc.GetString(bytes)
        Console.WriteLine("Round-trip: {0}", str1.Equals(str2))
        If Not str1.Equals(str2) Then
            Console.WriteLine(str2)
            For Each ch In str2
                Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
            Next
            Console.WriteLine()
        End If
    End Sub
End Module
' The example displays the following output:
'       Ⓢ ⁵ ∞
'       24C8 0020 2075 0020 221E
'       
'       Encoded bytes: 3F 20 3F 20 3F
'       
'       Round-trip: False
'       ? ? ?
'       003F 0020 003F 0020 003F

.NET, bir karakterin kodlama veya kod çözme işlemi sırasında tam olarak eşlenmemesi durumunda bir değiştirme dizgesi kullanan EncoderReplacementFallback ve DecoderReplacementFallback sınıflarını içerir. Varsayılan olarak, bu değiştirme dizesi bir soru işaretidir, ancak farklı bir dize seçmek için sınıf oluşturucusunun aşırı yüklenmiş bir versiyonunu çağırabilirsiniz. Genellikle, değiştirme dizesi tek bir karakterdir, ancak bu bir gereksinim değildir. Aşağıdaki örnek, değiştirme dizesi olarak yıldız (*) kullanan bir EncoderReplacementFallback nesnesinin örneğini oluşturarak kod sayfası 1252 kodlayıcısının davranışını değiştiriyor.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      Encoding cp1252r = Encoding.GetEncoding(1252,
                                  new EncoderReplacementFallback("*"),
                                  new DecoderReplacementFallback("*"));

      string str1 = "\u24C8 \u2075 \u221E";
      Console.WriteLine(str1);
      foreach (var ch in str1)
         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));

      Console.WriteLine();

      byte[] bytes = cp1252r.GetBytes(str1);
      string str2 = cp1252r.GetString(bytes);
      Console.WriteLine($"Round-trip: {str1.Equals(str2)}");
      if (! str1.Equals(str2)) {
         Console.WriteLine(str2);
         foreach (var ch in str2)
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       Ⓢ ⁵ ∞
//       24C8 0020 2075 0020 221E
//       Round-trip: False
//       * * *
//       002A 0020 002A 0020 002A

Imports System.Text

Module Example
    Public Sub Main()
        Dim cp1252r As Encoding = Encoding.GetEncoding(1252,
                                           New EncoderReplacementFallback("*"),
                                           New DecoderReplacementFallback("*"))

        Dim str1 As String = String.Format("{0} {1} {2}", ChrW(&h24C8), ChrW(&h2075), ChrW(&h221E))
        Console.WriteLine(str1)
        For Each ch In str1
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
        Next
        Console.WriteLine()

        Dim bytes() As Byte = cp1252r.GetBytes(str1)
        Dim str2 As String = cp1252r.GetString(bytes)
        Console.WriteLine("Round-trip: {0}", str1.Equals(str2))
        If Not str1.Equals(str2) Then
            Console.WriteLine(str2)
            For Each ch In str2
                Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
            Next
            Console.WriteLine()
        End If
    End Sub
End Module
' The example displays the following output:
'       Ⓢ ⁵ ∞
'       24C8 0020 2075 0020 221E
'       Round-trip: False
'       * * *
'       002A 0020 002A 0020 002A

Uyarı

Kodlama için bir değiştirme sınıfı da uygulayabilirsiniz. Daha fazla bilgi için Özel Geri Dönüş Stratejisini Uygulama bölümüne bakın.

SORU İŞARETİ'ne (U+003F) ek olarak, Unicode DEĞİşTİrME KARAKTERİ (U+FFFD), özellikle unicode karakterlerine başarıyla çevrilemeyen bayt dizilerinin kodunu çözdüğünüzde genellikle değiştirme dizesi olarak kullanılır. Ancak, yerine koymak için herhangi bir dizeyi seçmekte özgürsünüz ve bu dize birden çok karakter içerebilir.

İstisna Yedek Çözümü

Kodlayıcı, en uygun bir geri dönüş veya değiştirme dizesi sağlamak yerine, bir karakter kümesini kodlayamazsa bir istisna oluşturabilir ve bir kod çözücü, bayt dizisinin kodunu çözemezse bir istisna oluşturabilir. Kodlama ve kod çözme işlemleri sırasında bir istisna fırlatmak için, EncoderExceptionFallback yöntemine sırasıyla bir DecoderExceptionFallback nesnesi ve bir Encoding.GetEncoding(String, EncoderFallback, DecoderFallback) nesnesi sağlayın. Aşağıdaki örnek, ASCIIEncoding sınıfıyla özel durum yedeklemesini gösterir.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      Encoding enc = Encoding.GetEncoding("us-ascii",
                                          new EncoderExceptionFallback(),
                                          new DecoderExceptionFallback());

      string str1 = "\u24C8 \u2075 \u221E";
      Console.WriteLine(str1);
      foreach (var ch in str1)
         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));

      Console.WriteLine("\n");

      // Encode the original string using the ASCII encoder.
      byte[] bytes = {};
      try {
         bytes = enc.GetBytes(str1);
         Console.Write("Encoded bytes: ");
         foreach (var byt in bytes)
            Console.Write("{0:X2} ", byt);

         Console.WriteLine();
      }
      catch (EncoderFallbackException e) {
         Console.Write("Exception: ");
         if (e.IsUnknownSurrogate())
            Console.WriteLine($"Unable to encode surrogate pair 0x{Convert.ToUInt16(e.CharUnknownHigh):X4} 0x{Convert.ToUInt16(e.CharUnknownLow):X3} at index {e.Index}.");
         else
            Console.WriteLine($"Unable to encode 0x{Convert.ToUInt16(e.CharUnknown):X4} at index {e.Index}.");
         return;
      }
      Console.WriteLine();

      // Decode the ASCII bytes.
      try {
         string str2 = enc.GetString(bytes);
         Console.WriteLine($"Round-trip: {str1.Equals(str2)}");
         if (! str1.Equals(str2)) {
            Console.WriteLine(str2);
            foreach (var ch in str2)
               Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));

            Console.WriteLine();
         }
      }
      catch (DecoderFallbackException e) {
         Console.Write("Unable to decode byte(s) ");
         foreach (byte unknown in e.BytesUnknown)
            Console.Write("0x{0:X2} ");

         Console.WriteLine($"at index {e.Index}");
      }
   }
}
// The example displays the following output:
//       Ⓢ ⁵ ∞
//       24C8 0020 2075 0020 221E
//
//       Exception: Unable to encode 0x24C8 at index 0.

Imports System.Text

Module Example
    Public Sub Main()
        Dim enc As Encoding = Encoding.GetEncoding("us-ascii",
                                                   New EncoderExceptionFallback(),
                                                   New DecoderExceptionFallback())

        Dim str1 As String = String.Format("{0} {1} {2}", ChrW(&h24C8), ChrW(&h2075), ChrW(&h221E))
        Console.WriteLine(str1)
        For Each ch In str1
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
        Next
        Console.WriteLine()
        Console.WriteLine()

        ' Encode the original string using the ASCII encoder.
        Dim bytes() As Byte = {}
        Try
            bytes = enc.GetBytes(str1)
            Console.Write("Encoded bytes: ")
            For Each byt In bytes
                Console.Write("{0:X2} ", byt)
            Next
            Console.WriteLine()
        Catch e As EncoderFallbackException
            Console.Write("Exception: ")
            If e.IsUnknownSurrogate() Then
                Console.WriteLine("Unable to encode surrogate pair 0x{0:X4} 0x{1:X3} at index {2}.",
                                  Convert.ToUInt16(e.CharUnknownHigh),
                                  Convert.ToUInt16(e.CharUnknownLow),
                                  e.Index)
            Else
                Console.WriteLine("Unable to encode 0x{0:X4} at index {1}.",
                                  Convert.ToUInt16(e.CharUnknown),
                                  e.Index)
            End If
            Exit Sub
        End Try
        Console.WriteLine()

        ' Decode the ASCII bytes.
        Try
            Dim str2 As String = enc.GetString(bytes)
            Console.WriteLine("Round-trip: {0}", str1.Equals(str2))
            If Not str1.Equals(str2) Then
                Console.WriteLine(str2)
                For Each ch In str2
                    Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
                Next
                Console.WriteLine()
            End If
        Catch e As DecoderFallbackException
            Console.Write("Unable to decode byte(s) ")
            For Each unknown As Byte In e.BytesUnknown
                Console.Write("0x{0:X2} ")
            Next
            Console.WriteLine("at index {0}", e.Index)
        End Try
    End Sub
End Module
' The example displays the following output:
'       Ⓢ ⁵ ∞
'       24C8 0020 2075 0020 221E
'       
'       Exception: Unable to encode 0x24C8 at index 0.

Uyarı

Kodlama işlemi için özel bir özel durum işleyicisi de uygulayabilirsiniz. Daha fazla bilgi için Özel Geri Dönüş Stratejisini Uygulama bölümüne bakın.

EncoderFallbackException ve DecoderFallbackException nesneleri, özel duruma neden olan koşul hakkında aşağıdaki bilgileri sağlar:

• EncoderFallbackException nesnesi, kodlanamayan karakterin veya karakterlerin bilinmeyen bir vekil çifti (bu durumda yöntemin döndürdüğüIsUnknownSurrogate) veya bilinmeyen bir tek karakteri (bu durumda yöntem döndürürtrue) temsil edip etmediğini gösteren bir yöntem içerirfalse. Vekil çiftindeki karakterlere EncoderFallbackException.CharUnknownHigh ve EncoderFallbackException.CharUnknownLow özelliklerinden erişilebilir. Bilinmeyen karakter, EncoderFallbackException.CharUnknown özelliğinden kullanılabilir. EncoderFallbackException.Index özelliği, dizede kodlanamayan ilk karakterin bulunduğu konumu gösterir.

• Nesne, kodlanamayan bir bayt dizisini döndüren DecoderFallbackException bir özellik içerir BytesUnknown. DecoderFallbackException.Index özelliği bilinmeyen baytların başlangıç konumunu gösterir.

Bununla birlikte, EncoderFallbackException ve DecoderFallbackException nesneleri özel durum hakkında yeterli tanılama bilgileri sağlasalar da, kodlama veya kod çözme arabelleğine erişim sağlamazlar. Bu nedenle, kodlama veya kod çözme yönteminde geçersiz verilerin değiştirilmesine veya düzeltilmesine izin vermezler.

Özel Geri Dönüş Stratejisi Uygulaması

.NET, kod sayfaları tarafından dahili olarak uygulanan en uygun eşlemeye ek olarak, geri dönüş stratejisi uygulamak için aşağıdaki sınıfları içerir:

• Kodlama işlemlerinde karakterleri değiştirmek için EncoderReplacementFallback ve EncoderReplacementFallbackBuffer kullanın.

• Kod çözme işlemlerinde karakterleri değiştirmek için DecoderReplacementFallback ve DecoderReplacementFallbackBuffer kullanın.

• Bir karakter kodlanamadığında EncoderExceptionFallback ve EncoderExceptionFallbackBuffer kullanarak bir EncoderFallbackException fırlatın.

• Karakterin kodu çözülemediğinde bir DecoderExceptionFallback atmak için DecoderExceptionFallbackBuffer ve DecoderFallbackException kullanın.

Ayrıca, aşağıdaki adımları izleyerek en uygun geri dönüş, yedek geri dönüş veya özel durum geri dönüşü kullanan özel bir çözüm uygulayabilirsiniz:

1. kodlama işlemleri için öğesinden EncoderFallback ve kod çözme işlemleri için öğesinden DecoderFallback bir sınıf türetin.

2. kodlama işlemleri için öğesinden EncoderFallbackBuffer ve kod çözme işlemleri için öğesinden DecoderFallbackBuffer bir sınıf türetin.

3. Özel durum geri dönüşü için, önceden tanımlanmış EncoderFallbackException ve DecoderFallbackException sınıflar gereksinimlerinizi karşılamıyorsa veya Exceptiongibi ArgumentException bir özel durum nesnesinden bir sınıf türetin.

EncoderFallback veya DecoderFallback'ten türetme

Özel bir geri dönüş çözümü uygulamak için, kodlama işlemleri için EncoderFallback öğesinden ve kod çözme işlemleri için DecoderFallback öğesinden devralan bir sınıf oluşturmanız gerekir. Bu sınıfların örnekleri yöntemine Encoding.GetEncoding(String, EncoderFallback, DecoderFallback) geçirilir ve kodlama sınıfı ile geri dönüş uygulaması arasında aracı görevi görür.

Kodlayıcı veya kod çözücü için özel bir geri dönüş çözümü oluşturduğunuzda aşağıdaki üyeleri uygulamanız gerekir:

• EncoderFallback.MaxCharCount veya DecoderFallback.MaxCharCount özelliği, en iyi uyum, değiştirme veya özel durum yedeklemesinin tek bir karakteri değiştirmek için döndürebileceği mümkün olan en fazla karakter sayısını döndürür. Özel özel durum geri dönüşü için değeri sıfırdır.

• Özel EncoderFallback.CreateFallbackBuffer veya DecoderFallback.CreateFallbackBuffer uygulamanızı döndüren EncoderFallbackBuffer veya DecoderFallbackBuffer yöntemi. yöntemi, başarıyla kodlayamadığı ilk karakterle karşılaştığında kodlayıcı tarafından veya kodu başarıyla çözemediği ilk baytla karşılaştığında kod çözücü tarafından çağrılır.

EncoderFallbackBuffer veya DecoderFallbackBuffer'dan türetme

Özel bir geri dönüş çözümü uygulamak için, kodlama işlemleri için EncoderFallbackBuffer öğesinden ve kod çözme işlemleri için DecoderFallbackBuffer öğesinden devralan bir sınıf oluşturmanız gerekir. Bu sınıfların örnekleri, CreateFallbackBuffer ve EncoderFallback sınıflarının DecoderFallback yöntemleri tarafından döndürülür. EncoderFallback.CreateFallbackBuffer yöntemi, kodlayamadığı ilk karakterle karşılaştığında kodlayıcı tarafından çağrılır ve DecoderFallback.CreateFallbackBuffer kodunu çözemediği bir veya daha fazla baytla karşılaştığında kod çözücü tarafından çağrılır. EncoderFallbackBuffer ve DecoderFallbackBuffer sınıfları geri dönüş uygulamasını sağlar. Her örnek, kodlanamayan karakterin veya kodlanamayan bayt dizisinin yerini alacak geri dönüş karakterlerini içeren bir arabelleği temsil eder.

Kodlayıcı veya kod çözücü için özel bir geri dönüş çözümü oluşturduğunuzda aşağıdaki üyeleri uygulamanız gerekir:

• EncoderFallbackBuffer.Fallback veya DecoderFallbackBuffer.Fallback metodu. EncoderFallbackBuffer.Fallback, kodlayıcı tarafından kodlayamayacağı karakter hakkında geri dönüş arabelleğine bilgi sağlamak için çağrılır. Kodlanacak karakter bir vekil çift olabileceğinden, bu yöntem aşırı yüklenmiştir. Bir aşırı yükleme, kodlanacak karaktere ve dizedeki dizinine geçirilir. İkinci aşırı yükleme, dizedeki diziniyle birlikte yüksek ve düşük vekile geçirilir. DecoderFallbackBuffer.Fallback yöntemi, kod çözücü tarafından, kodunu çözemediği baytlar hakkında geri dönüş arabelleğine bilgi sağlamak için çağrılır. Bu yönteme, kodlayamadığı bir bayt dizisi ve ilk baytın dizini verilir. Geri alma arabelleği en uygun veya yedek karakter veya karakterleri sağlayabiliyorsa, geri alma yöntemi true döndürmelidir; aksi takdirde, false döndürmelidir. Bir istisna geri dönüşü için, geri dönüş yöntemi bir istisna oluşturmalıdır.

• EncoderFallbackBuffer.GetNextChar veya DecoderFallbackBuffer.GetNextChar yöntemi, kodlayıcı veya kod çözücü tarafından geri dönüş tamponundan sıradaki karakteri almak için tekrar tekrar çağrılır. Tüm geri dönüş karakterleri döndürüldüyse yöntemi U+0000 döndürmelidir.

• EncoderFallbackBuffer.Remaining veya DecoderFallbackBuffer.Remaining özelliği, geri dönüş arabelleğinde kalan karakter sayısını döndürür.

• EncoderFallbackBuffer.MovePrevious veya DecoderFallbackBuffer.MovePrevious metodu, geri dönüş arabelleğindeki geçerli konumu önceki karaktere taşır.

• EncoderFallbackBuffer.Reset veya DecoderFallbackBuffer.Reset yöntemi, geri dönüş arabelleğini yeniden başlatır.

Yedekleme uygulaması en uygun yedekleme veya yerine yedekleme ise, ve sınıflarından türetilen sınıflar, iki özel örnek alanı da tutar: arabellekteki tam karakter sayısı; ve döndürülecek arabellekteki sonraki karakterin dizini.

EncoderFallback Örneği

Önceki bir örnekte, ASCII karakterlerine karşılık olmayan Unicode karakterleri yıldız (*) ile değiştirmek için yedek geri dönüş kullanılmıştır. Aşağıdaki örnek, ASCII olmayan karakterlerin daha iyi eşlemesini sağlamak için bunun yerine özel en uygun geri dönüş uygulamasını kullanır.

Aşağıdaki kod, ASCII olmayan karakterlerin en iyi eşleştirilmesini işlemek için CustomMapper'den türetilen EncoderFallback adlı bir sınıfı tanımlar. CreateFallbackBuffer yöntemi, CustomMapperFallbackBuffer uygulamasını sağlayan bir EncoderFallbackBuffer nesnesi döndürür. sınıfı, CustomMapper desteklenmeyen Unicode karakterlerinin (anahtar değeri) ve karşılık gelen 8 bit karakterlerinin (64 bit tamsayıda ardışık iki bayt olarak depolanır) eşlemelerini depolamak için bir Dictionary<TKey,TValue> nesnesi kullanır. Bu eşlemeyi geri dönüş arabelleğinde kullanılabilir hale getirmek için CustomMapper örneği, CustomMapperFallbackBuffer sınıf oluşturucusunun parametresi olarak geçirilir. En uzun eşleme U+221E Unicode karakteri için "INF" dizesi olduğundan, MaxCharCount özelliği 3 döndürür.

public class CustomMapper : EncoderFallback
{
   public string DefaultString;
   internal Dictionary<ushort, ulong> mapping;

   public CustomMapper() : this("*")
   {
   }

   public CustomMapper(string defaultString)
   {
      this.DefaultString = defaultString;

      // Create table of mappings
      mapping = new Dictionary<ushort, ulong>();
      mapping.Add(0x24C8, 0x53);
      mapping.Add(0x2075, 0x35);
      mapping.Add(0x221E, 0x49004E0046);
   }

   public override EncoderFallbackBuffer CreateFallbackBuffer()
   {
      return new CustomMapperFallbackBuffer(this);
   }

   public override int MaxCharCount
   {
      get { return 3; }
   }
}

Public Class CustomMapper : Inherits EncoderFallback
    Public DefaultString As String
    Friend mapping As Dictionary(Of UShort, ULong)

    Public Sub New()
        Me.New("?")
    End Sub

    Public Sub New(ByVal defaultString As String)
        Me.DefaultString = defaultString

        ' Create table of mappings
        mapping = New Dictionary(Of UShort, ULong)
        mapping.Add(&H24C8, &H53)
        mapping.Add(&H2075, &H35)
        mapping.Add(&H221E, &H49004E0046)
    End Sub

    Public Overrides Function CreateFallbackBuffer() As System.Text.EncoderFallbackBuffer
        Return New CustomMapperFallbackBuffer(Me)
    End Function

    Public Overrides ReadOnly Property MaxCharCount As Integer
        Get
            Return 3
        End Get
    End Property
End Class

Aşağıdaki kod, CustomMapperFallbackBuffer sınıfından türetilen EncoderFallbackBuffer sınıfını tanımlar. En uygun eşlemeleri içeren ve CustomMapper örneği içinde tanımlanan sözlük, sınıf kurucusundan erişilebilir. Yöntemi Fallback , ASCII kodlayıcının kodlayamayacağı Unicode karakterlerinden herhangi biri eşleme sözlüğünde tanımlanmışsa döndürür true ; aksi takdirde döndürür false. Her geri dönüş için, özel count değişken döndürülecek karakterlerin sayısını, özel index değişken ise döndürülecek bir sonraki karakterin dize arabelleğindeki charsToReturnkonumunu gösterir.

public class CustomMapperFallbackBuffer : EncoderFallbackBuffer
{
   int count = -1;                   // Number of characters to return
   int index = -1;                   // Index of character to return
   CustomMapper fb;
   string charsToReturn;

   public CustomMapperFallbackBuffer(CustomMapper fallback)
   {
      this.fb = fallback;
   }

   public override bool Fallback(char charUnknownHigh, char charUnknownLow, int index)
   {
      // Do not try to map surrogates to ASCII.
      return false;
   }

   public override bool Fallback(char charUnknown, int index)
   {
      // Return false if there are already characters to map.
      if (count >= 1) return false;

      // Determine number of characters to return.
      charsToReturn = String.Empty;

      ushort key = Convert.ToUInt16(charUnknown);
      if (fb.mapping.ContainsKey(key)) {
         byte[] bytes = BitConverter.GetBytes(fb.mapping[key]);
         int ctr = 0;
         foreach (var byt in bytes) {
            if (byt > 0) {
               ctr++;
               charsToReturn += (char) byt;
            }
         }
         count = ctr;
      }
      else {
         // Return default.
         charsToReturn = fb.DefaultString;
         count = 1;
      }
      this.index = charsToReturn.Length - 1;

      return true;
   }

   public override char GetNextChar()
   {
      // We'll return a character if possible, so subtract from the count of chars to return.
      count--;
      // If count is less than zero, we've returned all characters.
      if (count < 0)
         return '\u0000';

      this.index--;
      return charsToReturn[this.index + 1];
   }

   public override bool MovePrevious()
   {
      // Original: if count >= -1 and pos >= 0
      if (count >= -1) {
         count++;
         return true;
      }
      else {
         return false;
      }
   }

   public override int Remaining
   {
      get { return count < 0 ? 0 : count; }
   }

   public override void Reset()
   {
      count = -1;
      index = -1;
   }
}

Public Class CustomMapperFallbackBuffer : Inherits EncoderFallbackBuffer

    Dim count As Integer = -1        ' Number of characters to return
    Dim index As Integer = -1        ' Index of character to return
    Dim fb As CustomMapper
    Dim charsToReturn As String

    Public Sub New(ByVal fallback As CustomMapper)
        MyBase.New()
        Me.fb = fallback
    End Sub

    Public Overloads Overrides Function Fallback(ByVal charUnknownHigh As Char, ByVal charUnknownLow As Char, ByVal index As Integer) As Boolean
        ' Do not try to map surrogates to ASCII.
        Return False
    End Function

    Public Overloads Overrides Function Fallback(ByVal charUnknown As Char, ByVal index As Integer) As Boolean
        ' Return false if there are already characters to map.
        If count >= 1 Then Return False

        ' Determine number of characters to return.
        charsToReturn = String.Empty

        Dim key As UShort = Convert.ToUInt16(charUnknown)
        If fb.mapping.ContainsKey(key) Then
            Dim bytes() As Byte = BitConverter.GetBytes(fb.mapping.Item(key))
            Dim ctr As Integer
            For Each byt In bytes
                If byt > 0 Then
                    ctr += 1
                    charsToReturn += Chr(byt)
                End If
            Next
            count = ctr
        Else
            ' Return default.
            charsToReturn = fb.DefaultString
            count = 1
        End If
        Me.index = charsToReturn.Length - 1

        Return True
    End Function

    Public Overrides Function GetNextChar() As Char
        ' We'll return a character if possible, so subtract from the count of chars to return.
        count -= 1
        ' If count is less than zero, we've returned all characters.
        If count < 0 Then Return ChrW(0)

        Me.index -= 1
        Return charsToReturn(Me.index + 1)
    End Function

    Public Overrides Function MovePrevious() As Boolean
        ' Original: if count >= -1 and pos >= 0
        If count >= -1 Then
            count += 1
            Return True
        Else
            Return False
        End If
    End Function

    Public Overrides ReadOnly Property Remaining As Integer
        Get
            Return If(count < 0, 0, count)
        End Get
    End Property

    Public Overrides Sub Reset()
        count = -1
        index = -1
    End Sub
End Class

Aşağıdaki kod daha sonra CustomMapper nesnesine bir örnek oluşturur ve Encoding.GetEncoding(String, EncoderFallback, DecoderFallback) metoduna bir örnek geçirir. Çıkış, en uygun geri dönüş uygulamasının özgün dizedeki ASCII olmayan üç karakteri başarıyla işlediğini gösterir.

using System;
using System.Collections.Generic;
using System.Text;

class Program
{
   static void Main()
   {
      Encoding enc = Encoding.GetEncoding("us-ascii", new CustomMapper(), new DecoderExceptionFallback());

      string str1 = "\u24C8 \u2075 \u221E";
      Console.WriteLine(str1);
      for (int ctr = 0; ctr <= str1.Length - 1; ctr++) {
         Console.Write("{0} ", Convert.ToUInt16(str1[ctr]).ToString("X4"));
         if (ctr == str1.Length - 1)
            Console.WriteLine();
      }
      Console.WriteLine();

      // Encode the original string using the ASCII encoder.
      byte[] bytes = enc.GetBytes(str1);
      Console.Write("Encoded bytes: ");
      foreach (var byt in bytes)
         Console.Write("{0:X2} ", byt);

      Console.WriteLine("\n");

      // Decode the ASCII bytes.
      string str2 = enc.GetString(bytes);
      Console.WriteLine($"Round-trip: {str1.Equals(str2)}");
      if (! str1.Equals(str2)) {
         Console.WriteLine(str2);
         foreach (var ch in str2)
            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));

         Console.WriteLine();
      }
   }
}

Imports System.Text
Imports System.Collections.Generic

Module Module1

    Sub Main()
        Dim enc As Encoding = Encoding.GetEncoding("us-ascii", New CustomMapper(), New DecoderExceptionFallback())

        Dim str1 As String = String.Format("{0} {1} {2}", ChrW(&H24C8), ChrW(&H2075), ChrW(&H221E))
        Console.WriteLine(str1)
        For ctr As Integer = 0 To str1.Length - 1
            Console.Write("{0} ", Convert.ToUInt16(str1(ctr)).ToString("X4"))
            If ctr = str1.Length - 1 Then Console.WriteLine()
        Next
        Console.WriteLine()

        ' Encode the original string using the ASCII encoder.
        Dim bytes() As Byte = enc.GetBytes(str1)
        Console.Write("Encoded bytes: ")
        For Each byt In bytes
            Console.Write("{0:X2} ", byt)
        Next
        Console.WriteLine()
        Console.WriteLine()

        ' Decode the ASCII bytes.
        Dim str2 As String = enc.GetString(bytes)
        Console.WriteLine("Round-trip: {0}", str1.Equals(str2))
        If Not str1.Equals(str2) Then
            Console.WriteLine(str2)
            For Each ch In str2
                Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
            Next
            Console.WriteLine()
        End If
    End Sub
End Module

Ayrıca bkz.

• .NET'de karakter kodlamaya giriş
• Encoder
• Decoder
• DecoderFallback
• Encoding
• EncoderFallback
• Genelleştirme ve yerelleştirme