Encoding Sınıf

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

Encoding.cs

Karakter kodlamayı temsil eder.

public ref class Encoding abstract : ICloneable

public abstract class Encoding : ICloneable

type Encoding = class
    interface ICloneable

Public MustInherit Class Encoding
Implements ICloneable

Devralma

Object

Encoding

Türetilmiş

System.Text.ASCIIEncoding

System.Text.UnicodeEncoding

System.Text.UTF32Encoding

System.Text.UTF7Encoding

System.Text.UTF8Encoding

Uygulamalar

ICloneable

Örnekler

Aşağıdaki örnek bir dizeyi bir kodlamadan diğerine dönüştürür.

Note

Dizi byte[] , bu örnekte kodlanmış verileri içeren tek türdür. .NET Char ve String türleri kendileri Unicode olduğundan GetChars çağrısı verilerin kodunu Unicode'a geri çözer.

using System;
using System.Text;

class ConvertExample
{
   static void Run()
   {
      string unicodeString = "This string contains the unicode character Pi (\u03a0)";

      // Create two different encodings.
      Encoding ascii = Encoding.ASCII;
      Encoding unicode = Encoding.Unicode;

      // Convert the string into a byte array.
      byte[] unicodeBytes = unicode.GetBytes(unicodeString);

      // Perform the conversion from one encoding to the other.
      byte[] asciiBytes = Encoding.Convert(unicode, ascii, unicodeBytes);
         
      // Convert the new byte[] into a char[] and then into a string.
      char[] asciiChars = new char[ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)];
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0);
      string asciiString = new string(asciiChars);

      // Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString);
      Console.WriteLine("Ascii converted string: {0}", asciiString);
   }
}

// The example displays the following output:
//    Original string: This string contains the unicode character Pi (Π)
//    Ascii converted string: This string contains the unicode character Pi (?)

Imports System.Text

Class Example1
   Shared Sub Run()
      Dim unicodeString As String = "This string contains the unicode character Pi (" & ChrW(&H03A0) & ")"

      ' Create two different encodings.
      Dim ascii As Encoding = Encoding.ASCII
      Dim unicode As Encoding = Encoding.Unicode

      ' Convert the string into a byte array.
      Dim unicodeBytes As Byte() = unicode.GetBytes(unicodeString)

      ' Perform the conversion from one encoding to the other.
      Dim asciiBytes As Byte() = Encoding.Convert(unicode, ascii, unicodeBytes)

      ' Convert the new byte array into a char array and then into a string.
      Dim asciiChars(ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)-1) As Char
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0)
      Dim asciiString As New String(asciiChars)

      ' Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString)
      Console.WriteLine("Ascii converted string: {0}", asciiString)
   End Sub
End Class
' The example displays the following output:
'    Original string: This string contains the unicode character Pi (Π)
'    Ascii converted string: This string contains the unicode character Pi (?)

Açıklamalar

Encoding sınıfı bir karakter kodlamasını temsil eder.

Kodlama, bir Unicode karakter kümesini bayt dizisine dönüştürme işlemidir. Buna karşılık kod çözme, kodlanmış bayt dizisini unicode karakter kümesine dönüştürme işlemidir. Unicode Dönüştürme Biçimleri (UTF) ve tarafından Encodingdesteklenen diğer kodlamalar hakkında bilgi için bkz. .NET'te Karakter Kodlama.

Encoding bayt dizileri gibi rastgele ikili veriler yerine Unicode karakterler üzerinde çalışmak üzere tasarlanmıştır. Rastgele ikili verileri metne kodlamanız gerekiyorsa, gibi Convert.ToBase64CharArrayyöntemler tarafından uygulanan uuencode gibi bir protokol kullanmalısınız.

.NET, geçerli Unicode kodlamalarını ve diğer kodlamaları Encoding desteklemek için sınıfının aşağıdaki uygulamalarını sağlar:

• ASCIIEncoding Unicode karakterlerini tek 7 bit ASCII karakterleri olarak kodlar. Bu kodlama yalnızca U+0000 ile U+007F arasındaki karakter değerlerini destekler. Kod sayfası 20127. ASCII alanı aracılığıyla da kullanılabilir.

• UTF7Encoding UTF-7 kodlamasını kullanarak Unicode karakterleri kodlar. Bu kodlama tüm Unicode karakter değerlerini destekler. Kod sayfası 65000. UTF7 alanı aracılığıyla da kullanılabilir.

• UTF8Encoding UTF-8 kodlamasını kullanarak Unicode karakterleri kodlar. Bu kodlama tüm Unicode karakter değerlerini destekler. Kod sayfası 65001. UTF8 alanı aracılığıyla da kullanılabilir.

• UnicodeEncoding UTF-16 kodlamasını kullanarak Unicode karakterlerini kodlar. Hem küçük endian hem de büyük endian bayt siparişleri desteklenir. Ayrıca Unicode özelliği ve BigEndianUnicode özelliği aracılığıyla da mevcuttur.

• UTF32Encoding UTF-32 kodlamasını kullanarak Unicode karakterleri kodlar. Hem küçük endian (kod sayfası 12000) hem de büyük endian (kod sayfası 12001) bayt siparişleri desteklenir. UTF32 alanı aracılığıyla da kullanılabilir.

Encoding sınıfı öncelikli olarak farklı kodlamalar ile Unicode arasında dönüştürmeye yöneliktir. Genellikle türetilmiş Unicode sınıflarından biri uygulamanız için doğru seçimdir.

GetEncoding yöntemini diğer kodlamaları elde etmek için kullanın ve tüm kodlamaların listesini almak için GetEncodings yöntemini çağırın.

Kodlama listesi

Aşağıdaki tabloda .NET tarafından desteklenen kodlamalar listelenmektedir. Her kodlamanın kod sayfası numarasını ve kodlamanın EncodingInfo.Name ve EncodingInfo.DisplayName özelliklerinin değerlerini listeler. .NET Framework desteği, .NET Core desteği veya .NET 5 ve üzeri destek sütunundaki onay işareti, temel alınan platformdan bağımsız olarak kod sayfasının bu .NET uygulaması tarafından yerel olarak desteklendiğini gösterir. .NET Framework için, tabloda listelenen diğer kodlamaların kullanılabilirliği işletim sistemine bağlıdır. .NET Core ve .NET 5 ve sonraki sürümler için, diğer kodlamalar System.Text.CodePagesEncodingProvider sınıfını kullanarak veya System.Text.EncodingProvider sınıfından türeterek yapılabilir.

Note

Özelliği uluslararası bir standarda karşılık gelen kod sayfaları EncodingInfo.Name mutlaka bu standartla tam olarak uyumlu değildir.

Kod sayfası	Name	Ekran adı	.NET Framework desteği	.NET Core desteği	.NET 5 ve üzeri desteği
37	IBM037	IBM EBCDIC (US-Canada)
437	IBM437	OEM Amerika Birleşik Devletleri
500	IBM500	IBM EBCDIC (Uluslararası)
708	ASMO-708	Arapça (ASMO 708)
720	DOS-720	Arapça (DOS)
737	ibm737	Yunanca (DOS)
775	ibm775	Baltık (DOS)
850	ibm850	Batı Avrupa (DOS)
852	ibm852	Orta Avrupa (DOS)
855	IBM855	OEM Kiril Alfabesi
857	ibm857	Türkçe (DOS)
858	IBM00858	OEM Çok Dilli Latin I
860	IBM860	Portekizce (DOS)
861	ibm861	İzlanda dili (DOS)
862	DOS-862	İbranice (DOS)
863	IBM863	Kanadalı Fransızca (DOS)
864	IBM864	Arapça (864)
865	IBM865	İskandinav (DOS)
866	cp866	Kiril alfabesi (DOS)
869	ibm869	Yunanca, Modern (DOS)
870	IBM870	IBM EBCDIC (Çok Dilli Latin-2)
874	windows-874	Tayca (Windows)
875	cp875	IBM EBCDIC (Modern Yunanca)
932	shift_jis	Japonca (Shift-JIS)
936	gb2312	Basitleştirilmiş Çince (GB2312)	✓
949	ks_c_5601-1987	Korece
950	big5	Geleneksel Çince (Big5)
1026	IBM1026	IBM EBCDIC (Türkçe Latin-5)
1047	IBM01047	IBM Latin-1
1140	IBM01140	IBM EBCDIC (ABD-Canada-Euro)
1141	IBM01141	IBM EBCDIC (Germany-Euro)
1142	IBM01142	IBM EBCDIC (Danimarka-Norway-Euro)
1143	IBM01143	IBM EBCDIC (Finlandiya-Sweden-Euro)
1144	IBM01144	IBM EBCDIC (Italy-Euro)
1145	IBM01145	IBM EBCDIC (Spain-Euro)
1146	IBM01146	IBM EBCDIC (UK-Euro)
1147	IBM01147	IBM EBCDIC (France-Euro)
1148	IBM01148	IBM EBCDIC (International-Euro)
1149	IBM01149	IBM EBCDIC (Icelandic-Euro)
1200	utf-16	Unicode	✓	✓	✓
1201	unicodeFFFE	Unicode (Büyük Endian)	✓	✓	✓
1250	windows-1250	Orta Avrupa (Windows)
1251	windows-1251	Kiril alfabesi (Windows)
1252	Windows-1252	Batı Avrupa (Windows)	✓
1253	windows-1253	Yunanca (Windows)
1254	windows-1254	Türkçe (Windows)
1255	windows-1255	İbranice (Windows)
1256	windows-1256	Arapça (Windows)
1257	windows-1257	Baltık (Windows)
1258	windows-1258	Vietnam dili (Windows)
1361	Johab	Kore dili (Johab)
10000	Macintosh	Batı Avrupa (Mac)
10001	x-mac-japonca	Japonca (Mac)
10002	x-mac-chinesetrad	Geleneksel Çince (Mac)
10003	x-mac-korece	Korece (Mac)	✓
10004	x-mac-arapça	Arapça (Mac)
10005	x-mac-İbranice	İbranice (Mac)
10006	x-mac-yunanca	Yunanca (Mac)
10007	x-mac-kiril	Kiril alfabesi (Mac)
10008	x-mac-chinesesimp	Basitleştirilmiş Çince (Mac)	✓
10010	x-mac-rumence	Rumence (Mac)
10017	x-mac-ukrayna	Ukrayna dili (Mac)
10021	x-mac-thai	Tay dili (Mac)
10029	x-mac-ce	Orta Avrupa (Mac)
10079	x-mac-İzlandaca	İzlanda dili (Mac)
10081	x-mac-turkish	Türkçe (Mac)
10082	x-mac-hırvat	Hırvat dili (Mac)
12000	utf-32	Unicode (UTF-32)	✓	✓	✓
12001	utf-32BE	Unicode (UTF-32 Big endian)	✓	✓	✓
20000	x-Chinese-CNS	Geleneksel Çince (CNS)
20001	x-cp20001	TCA Tayvan
20002	x-Chinese-Eten	Geleneksel Çince (Eten)
20003	x-cp20003	Tayvan IBM5550
20004	x-cp20004	TeleText Tayvan
20005	x-cp20005	Wang Tayvan
20105	x-IA5	Batı Avrupa (IA5)
20106	x-IA5-Almanca	Almanca (IA5)
20107	x-IA5-İsveççe	İsveççe (IA5)
20108	x-IA5-Norveççe	Norveç dili (IA5)
20127	us-ascii	US-ASCII	✓	✓	✓
20261	x-cp20261	T.61
20269	x-cp20269	ISO-6937
20273	IBM273	IBM EBCDIC (Almanya)
20277	IBM277	IBM EBCDIC (Denmark-Norway)
20278	IBM278	IBM EBCDIC (Finland-Sweden)
20280	IBM280	IBM EBCDIC (İtalya)
20284	IBM284	IBM EBCDIC (İspanya)
20285	IBM285	IBM EBCDIC (BIRLEŞIK KRALLıK)
20290	IBM290	IBM EBCDIC (Japonca katakana)
20297	IBM297	IBM EBCDIC (Fransa)
20420	IBM420	IBM EBCDIC (Arapça)
20423	IBM423	IBM EBCDIC (Yunanca)
20424	IBM424	IBM EBCDIC (İbranice)
20833	x-EBCDIC-KoreanExtended	IBM EBCDIC (KoreCe Genişletilmiş)
20838	IBM-Thai	IBM EBCDIC (Tayca)
20866	koi8-r	Kiril Alfabesi (KOI8-R)
20871	IBM871	IBM EBCDIC (İzlandaca)
20880	IBM880	IBM EBCDIC (Kiril Rusça)
20905	IBM905	IBM EBCDIC (Türkçe)
20924	IBM00924	IBM Latin-1
20932	EUC-JP	Japonca (JIS 0208-1990 ve 0212-1990)
20936	x-cp20936	Basitleştirilmiş Çince (GB2312-80)	✓
20949	x-cp20949	Kore Wansung	✓
21025	cp1025	IBM EBCDIC (Kiril Serbian-Bulgarian)
21866	koi8-u	Kiril (KOI8-U)
28591	iso-8859-1	Batı Avrupa (ISO)	✓	✓	✓
28592	iso-8859-2	Orta Avrupa (ISO)
28593	iso-8859-3	Latin 3 (ISO)
28594	iso-8859-4	Baltık (ISO)
28595	iso-8859-5	Kiril Alfabesi (ISO)
28596	iso-8859-6	Arapça (ISO)
28597	iso-8859-7	Yunanca (ISO)
28598	iso-8859-8	İbranice (ISO-Visual)	✓
28599	iso-8859-9	Türkçe (ISO)
28603	iso-8859-13	Estonca (ISO)
28605	iso-8859-15	Latin 9 (ISO)
29001	x-Europa	Europa
38598	iso-8859-8-i	İbranice (ISO-Logical)	✓
50220	iso-2022-jp	Japonca (JIS)	✓
50221	csISO2022JP	Japonca (JIS-Allow 1 bayt Kana)	✓
50222	iso-2022-jp	Japonca (JIS-Allow 1 byte Kana - SO/SI)	✓
50225	iso-2022-kr	Kore dili (ISO)	✓
50227	x-cp50227	Basitleştirilmiş Çince (ISO-2022)	✓
51932	euc-jp	Japonca (EUC)	✓
51936	EUC-CN	Basitleştirilmiş Çince (EUC)	✓
51949	euc-kr	Kore dili (EUC)	✓
52936	hz-gb-2312	Basitleştirilmiş Çince (HZ)	✓
54936	GB18030	Basitleştirilmiş Çince (GB18030)	✓
57002	x-iscii-de	ISCII Devanagari	✓
57003	x-iscii-be	ISCII Bengal Alfabesi	✓
57004	x-iscii-ta	ISCII Tamil	✓
57005	x-iscii-te	ISCII Telugu	✓
57006	x-iscii-as	ISCII Assam dili	✓
57007	x-iscii-or	ISCII Orya	✓
57008	x-iscii-ka	ISCII Kannada	✓
57009	x-iscii-ma	ISCII Malayalam	✓
57010	x-iscii-gu	ISCII Gujarati	✓
57011	x-iscii-pa	ISCII Pencap dili	✓
65000	utf-7	Unicode (UTF-7)	✓	✓
65001	utf-8	Unicode (UTF-8)	✓	✓	✓

Aşağıdaki örnek, Yunanca (Windows) kod sayfası kodlamasını almak için GetEncoding(Int32) ve GetEncoding(String) yöntemlerini çağırır. Yöntem çağrıları Encoding tarafından döndürülen nesneleri karşılaştırarak eşit olduklarını gösterir ve ardından haritalar, Unicode kod noktasını ve Yunan alfabesindeki her karakter için karşılık gelen kod sayfası değerini görüntüler.

using System;
using System.Text;

public class GetEncodingExample
{
   public static void Run()
   {
      Encoding enc = Encoding.GetEncoding(1253);
      Encoding altEnc = Encoding.GetEncoding("windows-1253");
      Console.WriteLine($"{enc.EncodingName} = Code Page {altEnc.CodePage}: {enc.Equals(altEnc)}");
      string greekAlphabet = "Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η " +
                             "Θ θ Ι ι Κ κ Λ λ Μ μ Ν ν Ξ ξ " +
                             "Ο ο Π π Ρ ρ Σ σ ς Τ τ Υ υ " +
                             "Φ φ Χ χ Ψ ψ Ω ω";
      Console.OutputEncoding = Encoding.UTF8;
      byte[] bytes = enc.GetBytes(greekAlphabet);
      Console.WriteLine("{0,-12} {1,20} {2,20:X2}", "Character",
                        "Unicode Code Point", "Code Page 1253");
      for (int ctr = 0; ctr < bytes.Length; ctr++) {
         if (greekAlphabet[ctr].Equals(' '))
            continue;

         Console.WriteLine("{0,-12} {1,20} {2,20:X2}", greekAlphabet[ctr],
                           GetCodePoint(greekAlphabet[ctr]), bytes[ctr]);
      }
   }

   private static string GetCodePoint(char ch)
   {
      string retVal = "u+";
      byte[] bytes = Encoding.Unicode.GetBytes(ch.ToString());
      for (int ctr = bytes.Length - 1; ctr >= 0; ctr--)
         retVal += bytes[ctr].ToString("X2");

      return retVal;
   }
}

// The example displays the following output:
//       Character      Unicode Code Point       Code Page 1253
//       Α                          u+0391                   C1
//       α                          u+03B1                   E1
//       Β                          u+0392                   C2
//       β                          u+03B2                   E2
//       Γ                          u+0393                   C3
//       γ                          u+03B3                   E3
//       Δ                          u+0394                   C4
//       δ                          u+03B4                   E4
//       Ε                          u+0395                   C5
//       ε                          u+03B5                   E5
//       Ζ                          u+0396                   C6
//       ζ                          u+03B6                   E6
//       Η                          u+0397                   C7
//       η                          u+03B7                   E7
//       Θ                          u+0398                   C8
//       θ                          u+03B8                   E8
//       Ι                          u+0399                   C9
//       ι                          u+03B9                   E9
//       Κ                          u+039A                   CA
//       κ                          u+03BA                   EA
//       Λ                          u+039B                   CB
//       λ                          u+03BB                   EB
//       Μ                          u+039C                   CC
//       μ                          u+03BC                   EC
//       Ν                          u+039D                   CD
//       ν                          u+03BD                   ED
//       Ξ                          u+039E                   CE
//       ξ                          u+03BE                   EE
//       Ο                          u+039F                   CF
//       ο                          u+03BF                   EF
//       Π                          u+03A0                   D0
//       π                          u+03C0                   F0
//       Ρ                          u+03A1                   D1
//       ρ                          u+03C1                   F1
//       Σ                          u+03A3                   D3
//       σ                          u+03C3                   F3
//       ς                          u+03C2                   F2
//       Τ                          u+03A4                   D4
//       τ                          u+03C4                   F4
//       Υ                          u+03A5                   D5
//       υ                          u+03C5                   F5
//       Φ                          u+03A6                   D6
//       φ                          u+03C6                   F6
//       Χ                          u+03A7                   D7
//       χ                          u+03C7                   F7
//       Ψ                          u+03A8                   D8
//       ψ                          u+03C8                   F8
//       Ω                          u+03A9                   D9
//       ω                          u+03C9                   F9

Imports System.Text

Module Example2
   Public Sub Run()
      Dim enc As Encoding = Encoding.GetEncoding(1253)
      Dim altEnc As Encoding = Encoding.GetEncoding("windows-1253")
      Console.WriteLine("{0} = Code Page {1}: {2}", enc.EncodingName,
                        altEnc.CodePage, enc.Equals(altEnc))
      Dim greekAlphabet As String = "Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η " +
                                    "Θ θ Ι ι Κ κ Λ λ Μ μ Ν ν Ξ ξ " +
                                    "Ο ο Π π Ρ ρ Σ σ ς Τ τ Υ υ " +
                                    "Φ φ Χ χ Ψ ψ Ω ω"
      Console.OutputEncoding = Encoding.UTF8
      Dim bytes() As Byte = enc.GetBytes(greekAlphabet)
      Console.WriteLine("{0,-12} {1,20} {2,20:X2}", "Character",
                        "Unicode Code Point", "Code Page 1253")
      For ctr As Integer = 0 To bytes.Length - 1
         If greekAlphabet(ctr).Equals(" "c) Then Continue For

         Console.WriteLine("{0,-12} {1,20} {2,20:X2}", greekAlphabet(ctr),
                           GetCodePoint(greekAlphabet(ctr)), bytes(ctr))
      Next

   End Sub

   Private Function GetCodePoint(ch As String) As String
      Dim retVal As String = "u+"
      Dim bytes() As Byte = Encoding.Unicode.GetBytes(ch)
      For ctr As Integer = bytes.Length - 1 To 0 Step -1
         retVal += bytes(ctr).ToString("X2")
      Next
      Return retVal
   End Function
End Module
' The example displays the following output:
'    Character      Unicode Code Point       Code Page 1253
'    Α                          u+0391                   C1
'    α                          u+03B1                   E1
'    Β                          u+0392                   C2
'    β                          u+03B2                   E2
'    Γ                          u+0393                   C3
'    γ                          u+03B3                   E3
'    Δ                          u+0394                   C4
'    δ                          u+03B4                   E4
'    Ε                          u+0395                   C5
'    ε                          u+03B5                   E5
'    Ζ                          u+0396                   C6
'    ζ                          u+03B6                   E6
'    Η                          u+0397                   C7
'    η                          u+03B7                   E7
'    Θ                          u+0398                   C8
'    θ                          u+03B8                   E8
'    Ι                          u+0399                   C9
'    ι                          u+03B9                   E9
'    Κ                          u+039A                   CA
'    κ                          u+03BA                   EA
'    Λ                          u+039B                   CB
'    λ                          u+03BB                   EB
'    Μ                          u+039C                   CC
'    μ                          u+03BC                   EC
'    Ν                          u+039D                   CD
'    ν                          u+03BD                   ED
'    Ξ                          u+039E                   CE
'    ξ                          u+03BE                   EE
'    Ο                          u+039F                   CF
'    ο                          u+03BF                   EF
'    Π                          u+03A0                   D0
'    π                          u+03C0                   F0
'    Ρ                          u+03A1                   D1
'    ρ                          u+03C1                   F1
'    Σ                          u+03A3                   D3
'    σ                          u+03C3                   F3
'    ς                          u+03C2                   F2
'    Τ                          u+03A4                   D4
'    τ                          u+03C4                   F4
'    Υ                          u+03A5                   D5
'    υ                          u+03C5                   F5
'    Φ                          u+03A6                   D6
'    φ                          u+03C6                   F6
'    Χ                          u+03A7                   D7
'    χ                          u+03C7                   F7
'    Ψ                          u+03A8                   D8
'    ψ                          u+03C8                   F8
'    Ω                          u+03A9                   D9
'    ω                          u+03C9                   F9

Dönüştürülecek veriler yalnızca sıralı bloklarda (bir akıştan okunan veriler gibi) mevcutsa veya veri miktarı çok büyük olup daha küçük bloklara bölünmesi gerekiyorsa, türetilmiş bir sınıfın Decoder veya Encoder yöntemini kullanmalısınız. Bu yöntemler GetDecoder veya GetEncoder metodları tarafından sağlanır.

UTF-16 ve UTF-32 kodlayıcıları büyük endian bayt sırasını (en önemli bayt önce) veya küçük endian bayt sırasını (en az önemli bayt önce) kullanabilir. Örneğin, Latin Büyük A Harfi (U+0041) aşağıdaki gibi serileştirilir (onaltılık):

• UTF-16 büyük endian bayt düzeni: 00 41
• UTF-16 küçük endian bayt düzeni: 41 00
• UTF-32 büyük endian bayt sıralaması: 00 00 00 41
• UTF-32 küçük uçlu bayt sırası: 41 00 00 00

Yerel bayt sırasını kullanarak Unicode karakterleri depolamak genellikle daha verimlidir. Örneğin, Intel bilgisayarlar gibi küçük endian platformlarında küçük endian bayt sırasını kullanmak daha iyidir.

GetPreamble yöntemi, bayt düzeni işaretini (BOM) içeren bir bayt dizisi geri döndürür. Bu bayt dizisi kodlanmış bir akışa ön ekliyse kod çözücüye kullanılan kodlama biçimini tanımlamasına yardımcı olur.

Bayt sırası ve bayt sırası işareti hakkında daha fazla bilgi için, Unicode giriş sayfasındaki Unicode Standardı'na bakın.

Kodlama sınıflarının hatalara izin verdiğini unutmayın:

• Sessizce "?" karakterine geçin.
• "En uygun" karakteri kullanın.
• EncoderFallback ve DecoderFallback sınıflarını kullanarak, U+FFFD Unicode değiştirme karakteri ile uygulamaya özgü bir davranışa geçin.

Herhangi bir veri akışı hatasında bir istisna fırlatmalısınız. Bir uygulama, uygun olduğunda "throwonerror" bayrağını veya EncoderExceptionFallback ve DecoderExceptionFallback sınıflarını kullanır. Veri kaybına veya karışıklığa neden olabileceği ve basit karakter değiştirmelerinden daha yavaş olduğu için en uygun geri dönüş genellikle önerilmez. ANSI kodlamaları için en uygun davranış varsayılandır.

Oluşturucular

Name	Description
Encoding()	Encoding sınıfının yeni bir örneğini başlatır.
Encoding(Int32, EncoderFallback, DecoderFallback)	Belirtilen kodlayıcı ve kod çözücü geri dönüş stratejileriyle belirtilen kod sayfasına karşılık gelen sınıfın yeni bir örneğini Encoding başlatır.
Encoding(Int32)	Sınıfın Encoding belirtilen kod sayfasına karşılık gelen yeni bir örneğini başlatır.

Özellikler

Name	Description
ASCII	ASCII (7 bit) karakter kümesi için bir kodlama alır.
BigEndianUnicode	UtF-16 biçimi için büyük endian bayt sırasını kullanan bir kodlama alır.
BodyName	Türetilmiş bir sınıfta geçersiz kılındığında, posta aracısı gövde etiketleriyle kullanılabilen geçerli kodlama için bir ad alır.
CodePage	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli Encodingöğesinin kod sayfası tanımlayıcısını alır.
DecoderFallback	Geçerli DecoderFallback nesnenin Encoding nesnesini alır veya ayarlar.
Default	Bu .NET uygulaması için varsayılan kodlamayı alır.
EncoderFallback	Geçerli EncoderFallback nesnenin Encoding nesnesini alır veya ayarlar.
EncodingName	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın okunabilir açıklamasını alır.
HeaderName	Türetilmiş bir sınıfta geçersiz kılındığında, posta aracısı üst bilgi etiketleriyle kullanılabilecek geçerli kodlama için bir ad alır.
IsBrowserDisplay	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın tarayıcı istemcileri tarafından içeriği görüntülemek için kullanılıp kullanılamayacağını belirten bir değer alır.
IsBrowserSave	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın içeriği kaydetmek için tarayıcı istemcileri tarafından kullanılıp kullanılamayacağını belirten bir değer alır.
IsMailNewsDisplay	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın posta ve haber istemcileri tarafından içerik görüntülemek için kullanılıp kullanılamayacağını belirten bir değer alır.
IsMailNewsSave	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın içeriği kaydetmek için posta ve haber istemcileri tarafından kullanılıp kullanılamayacağını belirten bir değer alır.
IsReadOnly	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın salt okunur olup olmadığını belirten bir değer alır.
IsSingleByte	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın tek bayt kod noktaları kullanıp kullanmadığını belirten bir değer alır.
Latin1	Latin1 karakter kümesi (ISO-8859-1) için bir kodlama alır.
Preamble	Türetilmiş bir sınıfta geçersiz kılındığında, kullanılan kodlamayı belirten bayt dizisini içeren bir span döndürür.
Unicode	Küçük endian bayt sırasını kullanarak UTF-16 biçimi için bir kodlama alır.
UTF32	Küçük endian bayt sırasını kullanarak UTF-32 biçimi için bir kodlama alır.
UTF7	Geçersiz. UTF-7 biçimi için bir kodlama alır.
UTF8	UTF-8 biçimi için bir kodlama alır.
WebName	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlama için İnternet Atanan Numaralar Yetkilisi'ne (IANA) kaydedilen adı alır.
WindowsCodePage	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamaya en yakın olan Windows işletim sistemi kodu sayfasını alır.

Yöntemler

Name	Description
Clone()	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli Encoding nesnenin sığ bir kopyasını oluşturur.
Convert(Encoding, Encoding, Byte[], Int32, Int32)	Bayt dizisindeki bayt aralığını bir kodlamadan diğerine dönüştürür.
Convert(Encoding, Encoding, Byte[])	Bayt dizisinin tamamını bir kodlamadan diğerine dönüştürür.
CreateTranscodingStream(Stream, Encoding, Encoding, Boolean)	bir iç ile dış Streamarasında verileri kodlamaya hizmet eden bir Encoding oluşturur, benzer şekildeEncoding.Convert(Encoding, Encoding, Byte[])
Equals(Object)	Belirtilen Object değerin geçerli örneğe eşit olup olmadığını belirler.
GetByteCount(Char[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisinden bir karakter kümesi kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(Char[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(Char*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter işaretçisinde başlayan bir karakter kümesini kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(ReadOnlySpan<Char>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter aralığındaki karakterleri kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(String, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizeden bir karakter kümesi kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki karakterleri kodlayarak üretilen bayt sayısını hesaplar.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki bir karakter kümesini belirtilen bayt dizisine kodlar.
GetBytes(Char[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki bir karakter kümesini bayt dizisine kodlar.
GetBytes(Char[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri bayt dizisine kodlar.
GetBytes(Char*, Int32, Byte*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter işaretçisinde başlayan bir karakter kümesini belirtilen bayt işaretçisinde başlayan bir bayt dizisine kodlar.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen salt okunur yayılma alanından bir dizi karakter bayt aralığına kodlar.
GetBytes(String, Int32, Int32, Byte[], Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki bir karakter kümesini belirtilen bayt dizisine kodlar.
GetBytes(String, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizede tarafından count belirtilen karakter sayısını belirtilenden başlayarak bayt dizisine indexkodlar.
GetBytes(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki tüm karakterleri bir bayt dizisine kodlar.
GetCharCount(Byte[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisinden bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(Byte*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt işaretçisinde başlayan bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(ReadOnlySpan<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, sağlanan salt okunur bayt aralığının kodunu çözerek üretilen karakter sayısını hesaplar.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bayt dizisinin kodunu belirtilen karakter dizisine çözer.
GetChars(Byte[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bayt dizisinin kodunu bir karakter kümesine çözer.
GetChars(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu bir karakter kümesine çözer.
GetChars(Byte*, Int32, Char*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt işaretçisinde başlayan bir bayt dizisinin kodunu, belirtilen karakter işaretçisinde başlayan bir dizi karaktere dönüştürür.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen salt okunur bayt aralığındaki tüm baytların kodunu bir karakter aralığına çözer.
GetDecoder()	Türetilmiş bir sınıfta geçersiz kılındığında, kodlanmış bayt dizisini bir karakter dizisine dönüştüren bir kod çözücü alır.
GetEncoder()	Türetilmiş bir sınıfta geçersiz kılındığında, Unicode karakter dizisini kodlanmış bayt dizisine dönüştüren bir kodlayıcı alır.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Belirtilen kod sayfası tanımlayıcısıyla ilişkili kodlamayı döndürür. Parametreler, kodlanamayan karakterler için bir hata işleyicisi ve kodu çözülemeyen bayt dizileri belirtir.
GetEncoding(Int32)	Belirtilen kod sayfası tanımlayıcısıyla ilişkili kodlamayı döndürür.
GetEncoding(String, EncoderFallback, DecoderFallback)	Belirtilen kod sayfası adıyla ilişkili kodlamayı döndürür. Parametreler, kodlanamayan karakterler için bir hata işleyicisi ve kodu çözülemeyen bayt dizileri belirtir.
GetEncoding(String)	Belirtilen kod sayfası adıyla ilişkili kodlamayı döndürür.
GetEncodings()	Tüm kodlamaları içeren bir dizi döndürür.
GetHashCode()	Geçerli örneğin karma kodunu döndürür.
GetMaxByteCount(Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter sayısını kodlayarak üretilen en fazla bayt sayısını hesaplar.
GetMaxCharCount(Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt sayısının kodunu çözerek üretilen en fazla karakter sayısını hesaplar.
GetPreamble()	Türetilmiş bir sınıfta geçersiz kılındığında, kullanılan kodlamayı belirten bir bayt dizisi döndürür.
GetString(Byte[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bir bayt dizisinin kodunu bir dizeye çözer.
GetString(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu bir dizeye çözer.
GetString(Byte*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bir adresten başlayan belirtilen sayıda bayt kodunu bir dizeye çözer.
GetString(ReadOnlySpan<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt aralığındaki tüm baytların kodunu bir dizeye çözer.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsAlwaysNormalized()	Varsayılan normalleştirme formunu kullanarak geçerli kodlamanın her zaman normalleştirilip normalleştirilmediğini belirten bir değer alır.
IsAlwaysNormalized(NormalizationForm)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen normalleştirme formunu kullanarak geçerli kodlamanın her zaman normalleştirilip normalleştirilmediğini belirten bir değer alır.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
RegisterProvider(EncodingProvider)	Bir kodlama sağlayıcısı kaydeder.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Hedef yeterince büyükse, belirtilen salt okunur yayılma alanından bir dizi karakter içeren bayt aralığına kodlar.
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Hedef yeterince büyükse, belirtilen salt okunur yayılma alanından bir dizi bayt karakterine kod çözer.

Uzantı Metotları

Name	Description
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Belirtilen ReadOnlySequence<T>byteöğesini kullanarak kodunu s olarak Encoding çözer ve sonucu öğesine writeryazar.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak öğesini s byteolarak Encoding kodlar ve sonucu olarak bytesdöndürür.
GetBytes(Encoding, ReadOnlySequence<Char>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak bir Byte diziye kodlar Encoding.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Belirtilen ReadOnlySpan<T> öğesini kullanarak byte belirtilenleri olarak Encodingkodlar ve sonucu öğesine writeryazar.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Belirtilen ReadOnlySequence<T>charöğesini kullanarak kodunu s olarak Encoding çözer ve sonucu öğesine writeryazar.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Belirtilen ReadOnlySequence<T>charöğesini kullanarak öğesinin kodunu s olarak Encoding çözer ve sonucu olarak charsçıkartır.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Belirtilen ReadOnlySpan<T>charöğesini kullanarak kodunu s olarak Encoding çözer ve sonucu öğesine writeryazar.
GetString(Encoding, ReadOnlySequence<Byte>)	Belirtilen kodunu, belirtilen ReadOnlySequence<T> kullanarak olarak String çözer Encoding.

Ayrıca bkz.

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