다음을 통해 공유


System.Text.Encoding 클래스

이 문서에서는 이 API에 대한 참조 설명서에 대한 추가 설명서를 제공합니다.

Encoding 클래스는 문자 인코딩을 나타냅니다.

인코딩은 유니코드 문자 집합을 바이트 시퀀스로 변환하는 프로세스입니다. 반면 디코딩은 인코딩된 바이트 시퀀스를 유니코드 문자 집합으로 변환하는 프로세스입니다. UTF(유니코드 변환 형식) 및 지원되는 Encoding기타 인코딩에 대한 자세한 내용은 .NET의 문자 인코딩을 참조하세요.

Encoding 는 바이트 배열과 같은 임의의 이진 데이터 대신 유니코드 문자에서 작동하기 위한 것입니다. 임의의 이진 데이터를 텍스트로 인코딩해야 하는 경우 uuencode와 같은 프로토콜을 사용해야 합니다. 이 프로토콜은 다음과 같은 Convert.ToBase64CharArray메서드에 의해 구현됩니다.

.NET은 현재 유니코드 인코딩 및 기타 인코딩을 지원하기 위해 클래스의 Encoding 다음 구현을 제공합니다.

  • ASCIIEncoding 유니코드 문자를 단일 7비트 ASCII 문자로 인코딩합니다. 이 인코딩은 U+0000과 U+007F 사이의 문자 값만 지원합니다. 코드 페이지 20127. 속성을 통해 ASCII 서도 사용할 수 있습니다.

  • UTF7Encoding UTF-7 인코딩을 사용하여 유니코드 문자를 인코딩합니다. 이 인코딩은 모든 유니코드 문자 값을 지원합니다. 코드 페이지 65000. 속성을 통해 UTF7 서도 사용할 수 있습니다.

  • UTF8Encoding UTF-8 인코딩을 사용하여 유니코드 문자를 인코딩합니다. 이 인코딩은 모든 유니코드 문자 값을 지원합니다. 코드 페이지 65001. 속성을 통해 UTF8 서도 사용할 수 있습니다.

  • UnicodeEncoding UTF-16 인코딩을 사용하여 유니코드 문자를 인코딩합니다. little endian 및 big endian 바이트 주문이 모두 지원됩니다. 속성 및 BigEndianUnicode 속성을 통해 Unicode 서도 사용할 수 있습니다.

  • UTF32Encoding UTF-32 인코딩을 사용하여 유니코드 문자를 인코딩합니다. little endian(코드 페이지 12000) 및 big endian(코드 페이지 12001) 바이트 주문이 모두 지원됩니다. 속성을 통해 UTF32 서도 사용할 수 있습니다.

Encoding 클래스는 주로 서로 다른 인코딩과 유니코드 간에 변환하기 위한 것입니다. 파생 유니코드 클래스 중 하나가 앱에 적합한 선택인 경우가 많습니다.

메서드를 GetEncoding 사용하여 다른 인코딩을 가져오고 메서드를 GetEncodings 호출하여 모든 인코딩 목록을 가져옵니다.

인코딩 목록

다음 표에서는 .NET에서 지원하는 인코딩을 나열합니다. 각 인코딩의 코드 페이지 번호와 인코딩 및 EncodingInfo.DisplayName 속성의 값을 나열합니다EncodingInfo.Name. .NET Framework 지원, .NET Core 지원 또는 .NET 5 이상 지원 열의 검사 표시는 기본 플랫폼에 관계없이 해당 .NET 구현에서 코드 페이지가 기본적으로 지원됨을 나타냅니다. .NET Framework의 경우 테이블에 나열된 다른 인코딩의 가용성은 운영 체제에 따라 달라집니다. .NET Core 및 .NET 5 이상 버전의 경우 클래스를 사용 System.Text.CodePagesEncodingProvider 하거나 클래스에서 System.Text.EncodingProvider 파생하여 다른 인코딩을 사용할 수 있습니다.

참고 항목

해당 속성이 EncodingInfo.Name 국제 표준에 해당하는 코드 페이지가 반드시 해당 표준을 완전히 준수하지는 않습니다.

코드 페이지 이름 표시 이름 .NET Framework 지원 .NET Core 지원 .NET 5 이상 지원
37 IBM037 IBM EBCDIC(미국-캐나다)
437 IBM437 OEM 미국
500 IBM500 IBM EBCDIC(International)
708 ASMO-708 아랍어(ASMO 708)
720 DOS-720 아랍어(DOS)
737 ibm737 그리스어(DOS)
775 ibm775 발트어(DOS)
850 ibm850 서유럽어(DOS)
852 ibm852 중부 유럽(DOS)
855 IBM855 OEM 키릴 자모
857 ibm857 터키어(DOS)
858 IBM00858 OEM 다국어 라틴어 I
860 IBM860 포르투갈어(DOS)
861 ibm861 아이슬란드어(DOS)
862 DOS-862 히브리어(DOS)
863 IBM863 프랑스어 캐나다어(DOS)
864 IBM864 아랍어(864)
865 IBM865 북유럽어(DOS)
866 cp866 키릴 자모(DOS)
869 ibm869 그리스어, 현대식(DOS)
870 IBM870 IBM EBCDIC(다국어 라틴어-2)
874 windows-874 태국어(Windows)
875 cp875 IBM EBCDIC(그리스어 현대)
932 shift_jis 일본어(Shift-JIS)
936 gb2312 중국어 간체(GB2312)
949 ks_c_5601-1987 한국어
950 big5 중국어 번체(Big5)
1026 IBM1026 IBM EBCDIC(터키어 라틴어-5)
1047 IBM01047 IBM Latin-1
1140 IBM01140 IBM EBCDIC(미국-캐나다-유로)
1141 IBM01141 IBM EBCDIC(독일-유로)
1142 IBM01142 IBM EBCDIC(덴마크-노르웨이-유로)
1143 IBM01143 IBM EBCDIC(핀란드-스웨덴-유로)
1144 IBM01144 IBM EBCDIC(이탈리아-유로)
1145 IBM01145 IBM EBCDIC(스페인-유로)
1146 IBM01146 IBM EBCDIC(영국-유로)
1147 IBM01147 IBM EBCDIC(프랑스-유로)
1148 IBM01148 IBM EBCDIC(International-Euro)
1149 IBM01149 IBM EBCDIC(아이슬란드-유로)
1200 utf-16 Unicode
1201 unicodeFFFE 유니코드(빅 엔디안)
1250 windows-1250 중부 유럽(Windows)
1251 windows-1251 키릴 자모(Windows)
1252 Windows-1252 Western European (Windows)
1253 windows-1253 그리스어(Windows)
1254 windows-1254 터키어(Windows)
1255 windows-1255 히브리어(Windows)
1256 windows-1256 아랍어(Windows)
1257 windows-1257 발트어(Windows)
1258 windows-1258 베트남어(Windows)
1361 Johab 한국어(조합)
10000 Macintosh 서유럽어(Mac)
10001 x-mac-japanese 일본어(Mac)
10002 x-mac-chinesetrad 중국어 번체(Mac)
10003 x-mac-korean 한국어(Mac)
10004 x-mac-arabic 아랍어(Mac)
10005 x-mac-hebrew 히브리어(Mac)
10006 x-mac-greek 그리스어(Mac)
10007 x-mac-키릴 자모 키릴 자모(Mac)
10008 x-mac-chinesesimp 중국어 간체(Mac)
10010 x-mac-루마니아어 루마니아어(Mac)
10017 x-mac-ukrainian 우크라이나어(Mac)
10021 x-mac-thai 태국어(Mac)
10029 x-mac-ce 중부 유럽(Mac)
10079 x-mac-icelandic 아이슬란드어(Mac)
10081 x-mac-터키어 터키어(Mac)
10082 x-mac-크로아티아어 크로아티아어(Mac)
12000 utf-32 유니코드(UTF-32)
12001 utf-32BE 유니코드(UTF-32 빅 엔디안)
20000 x-중국어-CNS 중국어 번체(CNS)
20001 x-cp20001 TCA 대만
20002 x-Chinese-Eten 중국어 번체(에텐)
20003 x-cp20003 대만 IBM5550
20004 x-cp20004 TeleText 대만
20005 x-cp20005 왕 대만
20105 x-IA5 서유럽어(IA5)
20106 x-IA5-German 독일어(IA5)
20107 x-IA5-스웨덴어 스웨덴어(IA5)
20108 x-IA5-노르웨이어 노르웨이어(IA5)
20127 us-ascii US-ASCII
20261 x-cp20261 T.61
20269 x-cp20269 ISO-6937
20273 IBM273 IBM EBCDIC(독일)
20277 IBM277 IBM EBCDIC(덴마크-노르웨이)
20278 IBM278 IBM EBCDIC(핀란드-스웨덴)
20280 IBM280 IBM EBCDIC(이탈리아)
20284 IBM284 IBM EBCDIC(스페인)
20285 IBM285 IBM EBCDIC(영국)
20290 IBM290 IBM EBCDIC(일본어 가타카나)
20297 IBM297 IBM EBCDIC(프랑스)
20420 IBM420 IBM EBCDIC(아랍어)
20423 IBM423 IBM EBCDIC(그리스어)
20424 IBM424 IBM EBCDIC(히브리어)
20833 x-EBCDIC-KoreanExtended IBM EBCDIC(한국어 확장)
20838 IBM-Thai IBM EBCDIC(태국어)
20866 koi8-r 키릴 자모(KOI8-R)
20871 IBM871 IBM EBCDIC(아이슬란드어)
20880 IBM880 IBM EBCDIC(키릴 자모 러시아어)
20905 IBM905 IBM EBCDIC(터키어)
20924 IBM00924 IBM Latin-1
20932 EUC-JP 일본어(JIS 0208-1990 및 0212-1990)
20936 x-cp20936 중국어 간체(GB2312-80)
20949 x-cp20949 한국어 완성
21025 cp1025 IBM EBCDIC(키릴 자모 세르비아어-불가리아어)
21866 koi8-u 키릴 자모(KOI8-U)
28591 iso-8859-1 서유럽어(ISO)
28592 iso-8859-2 중앙 유럽(ISO)
28593 iso-8859-3 라틴어 3(ISO)
28594 iso-8859-4 발트어(ISO)
28595 iso-8859-5 키릴 자모(ISO)
28596 iso-8859-6 아랍어(ISO)
28597 iso-8859-7 그리스어(ISO)
28598 iso-8859-8 히브리어(ISO-Visual)
28599 iso-8859-9 터키어(ISO)
28603 iso-8859-13 에스토니아어(ISO)
28605 iso-8859-15 라틴어 9(ISO)
29001 x-Europa 유로파
38598 iso-8859-8-i 히브리어(ISO 논리)
50220 iso-2022-jp 일본어(JIS)
50221 csISO2022JP 일본어(JIS 허용 1바이트 가나)
50222 iso-2022-jp 일본어(JIS 허용 1바이트 가나 - SO/SI)
50225 iso-2022-kr 한국어(ISO)
50227 x-cp50227 중국어 간체(ISO-2022)
51932 euc-jp 일본어(EUC)
51936 EUC-CN 중국어 간체(EUC)
51949 euc-kr 한국어(EUC)
52936 hz-gb-2312 중국어 간체(HZ)
54936 GB18030 중국어 간체(GB18030)
57002 x-iscii-de ISCII 데바나가리
57003 x-iscii-be ISCII 벵골어
57004 x-iscii-ta ISCII 타밀어
57005 x-iscii-te ISCII 텔루구어
57006 x-iscii-as ISCII Assamese
57007 x-iscii-or ISCII 오리야
57008 x-iscii-ka ISCII Kannada
57009 x-iscii-ma ISCII 말라얄람
57010 x-iscii-gu ISCII 구자라트어
57011 x-iscii-pa ISCII 펀자브어
65000 utf-7 유니코드(UTF-7)
65001 utf-8 유니코드(UTF-8)

다음 예제에서는 및 메서드를 GetEncoding(Int32)GetEncoding(String) 호출하여 그리스어(Windows) 코드 페이지 인코딩을 가져옵니다. 메서드 호출에서 반환된 개체를 비교하여 Encoding 동일한 것을 표시한 다음, 맵은 그리스어 알파벳의 각 문자에 대한 유니코드 코드 포인트와 해당 코드 페이지 값을 표시합니다.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      Encoding enc = Encoding.GetEncoding(1253);
      Encoding altEnc = Encoding.GetEncoding("windows-1253");
      Console.WriteLine("{0} = Code Page {1}: {2}", enc.EncodingName,
                        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 Example
   Public Sub Main()
      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

변환할 데이터를 순차 블록(예: 스트림에서 읽은 데이터)에서만 사용할 수 있거나 데이터의 양이 너무 커서 더 작은 블록으로 나누어야 하는 경우 파생 클래스의 메서드 또는 메서드에서 각각 제공 GetDecoder 된 데이터나 GetEncoderEncoder 메서드를 사용해야 Decoder 합니다.

UTF-16 및 UTF-32 인코더는 big endian 바이트 순서(가장 중요한 바이트 우선) 또는 작은 엔디안 바이트 순서(가장 중요하지 않은 바이트 우선)를 사용할 수 있습니다. 예를 들어 라틴 문자 A(U+0041)는 다음과 같이 직렬화됩니다(16진수).

  • UTF-16 big endian 바이트 순서: 00 41
  • UTF-16 little endian 바이트 순서: 41 00
  • UTF-32 big endian 바이트 순서: 00 00 00 41
  • UTF-32 little endian 바이트 순서: 41 00 00 00

일반적으로 네이티브 바이트 순서를 사용하여 유니코드 문자를 저장하는 것이 더 효율적입니다. 예를 들어 Intel 컴퓨터와 같은 little endian 플랫폼에서 작은 엔디안 바이트 순서를 사용하는 것이 좋습니다.

메서드는 GetPreamble BOM(바이트 순서 표시)을 포함하는 바이트 배열을 검색합니다. 이 바이트 배열이 인코딩된 스트림에 접두사를 지정하면 디코더가 사용되는 인코딩 형식을 식별하는 데 도움이 됩니다.

바이트 순서 및 바이트 순서 표시에 대한 자세한 내용은 유니코드 홈페이지의 유니코드 표준을 참조하세요.

인코딩 클래스는 다음과 같은 오류를 허용합니다.

  • 자동으로 "?" 문자로 변경합니다.
  • "최적" 문자를 사용합니다.
  • 사용 하 여 애플리케이션별 동작을 변경 합니다 EncoderFallbackDecoderFallback U + FFFD 유니코드 대체 문자로 클래스입니다.

데이터 스트림 오류에 대해 예외를 throw해야 합니다. 앱은 해당하는 경우 "throwonerror" 플래그를 사용하거나 및 DecoderExceptionFallback 클래스를 EncoderExceptionFallback 사용합니다. 가장 적합한 대체(fallback)는 데이터 손실이나 혼동을 일으킬 수 있고 단순 문자 교체보다 느리기 때문에 권장되지 않는 경우가 많습니다. ANSI 인코딩의 경우 가장 적합한 동작이 기본값입니다.