UTF8Encoding 클래스

정의

유니코드 문자의 UTF-8 인코딩을 나타냅니다.Represents a UTF-8 encoding of Unicode characters.

public ref class UTF8Encoding : System::Text::Encoding
public class UTF8Encoding : System.Text.Encoding
[System.Serializable]
public class UTF8Encoding : System.Text.Encoding
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class UTF8Encoding : System.Text.Encoding
type UTF8Encoding = class
    inherit Encoding
[<System.Serializable>]
type UTF8Encoding = class
    inherit Encoding
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type UTF8Encoding = class
    inherit Encoding
Public Class UTF8Encoding
Inherits Encoding
상속
UTF8Encoding
특성

예제

다음 예제에서는 개체를 사용 하 여 UTF8Encoding 유니코드 문자 문자열을 인코딩하고 바이트 배열에 저장 합니다.The following example uses a UTF8Encoding object to encode a string of Unicode characters and store them in a byte array. 유니코드 문자열에는 두 문자 (Pi (U + 03A0)와 시그마 (U + 03A3))가 포함 되어 있습니다 .이 문자는 ASCII 문자 범위를 벗어납니다.The Unicode string includes two characters, Pi (U+03A0) and Sigma (U+03A3), that are outside the ASCII character range. 인코딩된 바이트 배열이 다시 문자열로 디코딩되 면 Pi 및 시그마 문자는 계속 표시 됩니다.When the encoded byte array is decoded back to a string, the Pi and Sigma characters are still present.

using namespace System;
using namespace System::Text;
//using namespace System::Collections;

int main()
{
   // Create a UTF-8 encoding.
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   
   // A Unicode string with two characters outside an 8-bit code range.
   String^ unicodeString = L"This Unicode string has 2 characters " +
                           L"outside the ASCII range:\n" +
                           L"Pi (\u03a0), and Sigma (\u03a3).";
   Console::WriteLine("Original string:");
   Console::WriteLine(unicodeString);
   
   // Encode the string.
   array<Byte>^ encodedBytes = utf8->GetBytes(unicodeString );
   Console::WriteLine();
   Console::WriteLine("Encoded bytes:");
   for (int ctr = 0; ctr < encodedBytes->Length; ctr++) {
      Console::Write( "{0:X2} ", encodedBytes[ctr]);
      if ((ctr + 1) % 25 == 0)
         Console::WriteLine();
   }

   Console::WriteLine();
   
   // Decode bytes back to string.
   String^ decodedString = utf8->GetString(encodedBytes);
   Console::WriteLine();
   Console::WriteLine("Decoded bytes:");
   Console::WriteLine(decodedString);
}
// The example displays the following output:
//    Original string:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    Encoded bytes:
//    54 68 69 73 20 55 6E 69 63 6F 64 65 20 73 74 72 69 6E 67 20 68 61 73 20 32
//    20 63 68 61 72 61 63 74 65 72 73 20 6F 75 74 73 69 64 65 20 74 68 65 20 41
//    53 43 49 49 20 72 61 6E 67 65 3A 20 0D 0A 50 69 20 28 CE A0 29 2C 20 61 6E
//    64 20 53 69 67 6D 61 20 28 CE A3 29 2E
//
//    Decoded bytes:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
using System;
using System.Text;

class Example
{
    public static void Main()
    {
        // Create a UTF-8 encoding.
        UTF8Encoding utf8 = new UTF8Encoding();
        
        // A Unicode string with two characters outside an 8-bit code range.
        String unicodeString =
            "This Unicode string has 2 characters outside the " +
            "ASCII range:\n" +
            "Pi (\u03a0), and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = utf8.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        for (int ctr = 0; ctr < encodedBytes.Length; ctr++) {
            Console.Write("{0:X2} ", encodedBytes[ctr]);
            if ((ctr + 1) %  25 == 0)
               Console.WriteLine();
        }
        Console.WriteLine();
        
        // Decode bytes back to string.
        String decodedString = utf8.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}
// The example displays the following output:
//    Original string:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    Encoded bytes:
//    54 68 69 73 20 55 6E 69 63 6F 64 65 20 73 74 72 69 6E 67 20 68 61 73 20 32
//    20 63 68 61 72 61 63 74 65 72 73 20 6F 75 74 73 69 64 65 20 74 68 65 20 41
//    53 43 49 49 20 72 61 6E 67 65 3A 20 0D 0A 50 69 20 28 CE A0 29 2C 20 61 6E
//    64 20 53 69 67 6D 61 20 28 CE A3 29 2E
//
//    Decoded bytes:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
Imports System.Text

Class Example
    Public Shared Sub Main()
        ' Create a UTF-8 encoding.
        Dim utf8 As New UTF8Encoding()
        
        ' A Unicode string with two characters outside an 8-bit code range.
        Dim unicodeString As String = _
            "This Unicode string has 2 characters outside the " &
            "ASCII range: " & vbCrLf &
            "Pi (" & ChrW(&h03A0) & "), and Sigma (" & ChrW(&h03A3) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        
        ' Encode the string.
        Dim encodedBytes As Byte() = utf8.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        For ctr As Integer = 0 To encodedBytes.Length - 1
            Console.Write("{0:X2} ", encodedBytes(ctr))
            If (ctr + 1) Mod 25 = 0 Then Console.WriteLine
        Next
        Console.WriteLine()
        
        ' Decode bytes back to string.
        Dim decodedString As String = utf8.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class
' The example displays the following output:
'    Original string:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).
'
'    Encoded bytes:
'    54 68 69 73 20 55 6E 69 63 6F 64 65 20 73 74 72 69 6E 67 20 68 61 73 20 32
'    20 63 68 61 72 61 63 74 65 72 73 20 6F 75 74 73 69 64 65 20 74 68 65 20 41
'    53 43 49 49 20 72 61 6E 67 65 3A 20 0D 0A 50 69 20 28 CE A0 29 2C 20 61 6E
'    64 20 53 69 67 6D 61 20 28 CE A3 29 2E
'
'    Decoded bytes:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).

다음 예에서는 인코딩된 바이트를 파일에 기록 하 고 BOM (바이트 순서 표시)을 사용 하 여 바이트 스트림에 접두사를 표시 한다는 점을 제외 하 고 이전 예제와 동일한 문자열을 사용 합니다.The following example uses the same string as the previous example, except that it writes the encoded bytes to a file and prefixes the byte stream with a byte order mark (BOM). 그런 다음 두 가지 방법, 즉 개체를 사용 하는 텍스트 파일과 이진 파일로 파일을 읽습니다. StreamReaderIt then reads the file in two different ways: as a text file by using a StreamReader object; and as a binary file. 짐작할 수 있듯이 새로 읽은 문자열에는 BOM이 포함 되지 않습니다.As you would expect, neither newly-read string includes the BOM.

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

public class Example
{
   public static void Main()
   {
        // Create a UTF-8 encoding that supports a BOM.
        Encoding utf8 = new UTF8Encoding(true);

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

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

        // Write the bytes to a file with a BOM.
        var fs = new FileStream(@".\UTF8Encoding.txt", FileMode.Create);
        Byte[] bom = utf8.GetPreamble();
        fs.Write(bom, 0, bom.Length);
        fs.Write(encodedBytes, 0, encodedBytes.Length);
        Console.WriteLine("Wrote {0} bytes to the file.", fs.Length);
        fs.Close();
        Console.WriteLine();

        // Open the file using StreamReader.
        var sr = new StreamReader(@".\UTF8Encoding.txt");
        String newString = sr.ReadToEnd();
        sr.Close();
        Console.WriteLine("String read using StreamReader:");
        Console.WriteLine(newString);
        Console.WriteLine();

        // Open the file as a binary file and decode the bytes back to a string.
        fs = new FileStream(@".\UTF8Encoding.txt", FileMode.Open);
        Byte[] bytes = new Byte[fs.Length];
        fs.Read(bytes, 0, (int)fs.Length);
        fs.Close();

        String decodedString = utf8.GetString(bytes);
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
   }
}
// The example displays the following output:
//    Original string:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    The encoded string has 88 bytes.
//
//    Wrote 91 bytes to the file.
//
//    String read using StreamReader:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    Decoded bytes:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
Imports System.IO
Imports System.Text

Class Example
    Public Shared Sub Main()
        ' Create a UTF-8 encoding that supports a BOM.
        Dim utf8 As New UTF8Encoding(True)
        
        ' A Unicode string with two characters outside an 8-bit code range.
        Dim unicodeString As String = _
            "This Unicode string has 2 characters outside the " &
            "ASCII range: " & vbCrLf &
            "Pi (" & ChrW(&h03A0) & "), and Sigma (" & ChrW(&h03A3) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        Console.WriteLine()
        
        ' Encode the string.
        Dim encodedBytes As Byte() = utf8.GetBytes(unicodeString)
        Console.WriteLine("The encoded string has {0} bytes.",
                          encodedBytes.Length)
        Console.WriteLine()
        
        ' Write the bytes to a file with a BOM.
        Dim fs As New FileStream(".\UTF8Encoding.txt", FileMode.Create)
        Dim bom() As Byte = utf8.GetPreamble()
        fs.Write(bom, 0, bom.Length)
        fs.Write(encodedBytes, 0, encodedBytes.Length)
        Console.WriteLine("Wrote {0} bytes to the file.", fs.Length)
        fs.Close()
        Console.WriteLine()
        
        ' Open the file using StreamReader.
        Dim sr As New StreamReader(".\UTF8Encoding.txt")
        Dim newString As String = sr.ReadToEnd()
        sr.Close()
        Console.WriteLine("String read using StreamReader:")
        Console.WriteLine(newString)
        Console.WriteLine()
        
        ' Open the file as a binary file and decode the bytes back to a string.
        fs = new FileStream(".\UTF8Encoding.txt", FileMode.Open)
        Dim bytes(fs.Length - 1) As Byte
        fs.Read(bytes, 0, fs.Length)
        fs.Close()

        Dim decodedString As String = utf8.GetString(bytes)
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class
' The example displays the following output:
'    Original string:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).
'
'    The encoded string has 88 bytes.
'
'    Wrote 91 bytes to the file.
'
'    String read using StreamReader:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).
'
'    Decoded bytes:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).

설명

인코딩은 유니코드 문자 집합을 바이트 시퀀스로 변환하는 프로세스입니다.Encoding is the process of transforming a set of Unicode characters into a sequence of bytes. 디코딩은 인코딩된 바이트 시퀀스를 유니코드 문자 집합으로 변환 하는 프로세스입니다.Decoding is the process of transforming a sequence of encoded bytes into a set of Unicode characters.

U t f-8은 각 코드 포인트를 1-4 바이트의 시퀀스로 나타내는 유니코드 인코딩입니다.UTF-8 is a Unicode encoding that represents each code point as a sequence of one to four bytes. Utf-16 및 UTF-32 인코딩과 달리 UTF-8 인코딩에는 "endian"가 필요 하지 않습니다. 인코딩 체계는 프로세서가 빅 endian 또는 작은 endian 인지에 관계 없이 동일 합니다.Unlike the UTF-16 and UTF-32 encodings, the UTF-8 encoding does not require "endianness"; the encoding scheme is the same regardless of whether the processor is big-endian or little-endian. UTF8Encoding Windows 코드 페이지 65001에 해당 합니다.UTF8Encoding corresponds to the Windows code page 65001. 에서 지 원하는 UTFs 및 다른 인코딩에 대 한 자세한 내용은 System.Text .NET Framework의 문자 인코딩을 참조 하세요.For more information about the UTFs and other encodings supported by System.Text, see Character Encoding in the .NET Framework.

UTF8EncodingBOM (바이트 순서 표시)을 제공할지 여부와 오류 검색을 사용할지 여부에 따라 여러 가지 방법으로 개체를 인스턴스화할 수 있습니다.You can instantiate a UTF8Encoding object in a number of ways, depending on whether you want to it to provide a byte order mark (BOM) and whether you want to enable error detection. 다음 표에서는 Encoding 개체를 반환 하는 생성자와 속성을 보여 줍니다 UTF8Encoding .The following table lists the constructors and the Encoding property that return a UTF8Encoding object.

멤버Member BOMBOM 오류 검색Error detection
Encoding.UTF8 YesYes 아니요 (대체 대체)No (Replacement fallback)
UTF8Encoding.UTF8Encoding() NoNo 아니요 (대체 대체)No (Replacement fallback)
UTF8Encoding.UTF8Encoding(Boolean) 구성 가능Configurable 아니요 (대체 대체)No (Replacement fallback)
UTF8Encoding.UTF8Encoding(Boolean, Boolean) 구성 가능Configurable 구성 가능Configurable

GetByteCount메서드는 유니코드 문자 집합을 인코딩할 바이트 수를 결정 하 고 GetBytes 메서드는 실제 인코딩을 수행 합니다.The GetByteCount method determines how many bytes result in encoding a set of Unicode characters, and the GetBytes method performs the actual encoding.

마찬가지로, GetCharCount 메서드는 바이트 시퀀스를 디코딩하는 문자 수를 결정 하 고 GetChars 및 메서드는 GetString 실제 디코딩을 수행 합니다.Likewise, the GetCharCount method determines how many characters result in decoding a sequence of bytes, and the GetChars and GetString methods perform the actual decoding.

여러 블록에 걸쳐 있는 데이터를 인코딩 또는 디코딩할 때 상태 정보를 저장할 수 있는 인코더 또는 디코더 (예: 10만 문자 세그먼트로 인코딩된 100만 문자 문자열)에서는 GetEncoder GetDecoder 각각 및 속성을 사용 합니다.For an encoder or decoder that is able to save state information when encoding or decoding data that spans multiple blocks (such as string of 1 million characters that is encoded in 100,000-character segments), use the GetEncoder and GetDecoder properties, respectively.

필요에 따라 UTF8Encoding 개체는 인코딩 프로세스의 결과로 생성 되는 바이트 스트림의 시작 부분에 접두사를 붙일 수 있는 바이트 배열인 BOM (바이트 순서 표시)을 제공 합니다.Optionally, the UTF8Encoding object provides a byte order mark (BOM), which is an array of bytes that can be prefixed to the beginning of the byte stream that results from the encoding process. U t f-8로 인코딩된 바이트 스트림에 BOM (바이트 순서 표시)이 앞에 있으면 디코더가 바이트 순서와 변환 형식 또는 UTF를 결정 하는 데 도움이 됩니다.If a UTF-8 encoded byte stream is prefaced with a byte order mark (BOM), it helps the decoder determine the byte order and the transformation format or UTF. 그러나 유니코드 표준에서는 u t f-8로 인코딩된 스트림의 BOM을 요구 하거나 권장 하지 않습니다.Note, however, that the Unicode Standard neither requires nor recommends a BOM in UTF-8 encoded streams. 바이트 순서 및 바이트 순서 표시에 대 한 자세한 내용은 유니코드 홈페이지에서 유니코드 표준을 참조 하세요.For more information on byte order and the byte order mark, see The Unicode Standard at the Unicode home page.

인코더가 BOM을 제공 하도록 구성 된 경우 메서드를 호출 하 여이를 검색할 수 있습니다. GetPreamble 그렇지 않으면이 메서드는 빈 배열을 반환 합니다.If the encoder is configured to provide a BOM, you can retrieve it by calling the GetPreamble method; otherwise, the method returns an empty array. 개체가 BOM 지원으로 구성 된 경우에도 UTF8Encoding 인코딩된 바이트 스트림의 시작 부분에 bom을 적절 하 게 포함 해야 합니다. 클래스의 인코딩 메서드는 UTF8Encoding 이 작업을 자동으로 수행 하지 않습니다.Note that, even if a UTF8Encoding object is configured for BOM support, you must include the BOM at the beginning of the encoded byte stream as appropriate; the encoding methods of the UTF8Encoding class do not do this automatically.

주의

오류 검색을 사용 하도록 설정 하 고 클래스 인스턴스를 보다 안전 하 게 만들려면 생성자를 호출 하 UTF8Encoding(Boolean, Boolean)throwOnInvalidBytes 매개 변수를로 설정 해야 합니다 true .To enable error detection and to make the class instance more secure, you should call the UTF8Encoding(Boolean, Boolean) constructor and set the throwOnInvalidBytes parameter to true. 오류 검색을 사용 하는 경우 잘못 된 문자 또는 바이트 시퀀스를 검색 하는 메서드는 예외를 throw ArgumentException 합니다.With error detection enabled, a method that detects an invalid sequence of characters or bytes throws an ArgumentException exception. 오류를 검색 하지 않으면 예외가 throw 되지 않으며 잘못 된 시퀀스가 일반적으로 무시 됩니다.Without error detection, no exception is thrown, and the invalid sequence is generally ignored.

참고

다른 .NET Framework 버전을 사용 하 여 개체를 serialize 하 고 deserialize 하는 경우 u t f-8로 인코딩된 개체의 상태는 유지 되지 않습니다.The state of a UTF-8 encoded object is not preserved if the object is serialized and deserialized using different .NET Framework versions.

생성자

UTF8Encoding()

UTF8Encoding 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the UTF8Encoding class.

UTF8Encoding(Boolean)

UTF8Encoding 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the UTF8Encoding class. 매개 변수는 유니코드 바이트 순서 표시를 제공할지 여부를 지정합니다.A parameter specifies whether to provide a Unicode byte order mark.

UTF8Encoding(Boolean, Boolean)

UTF8Encoding 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the UTF8Encoding class. 매개 변수를 사용하여 유니코드 바이트 순서 표시를 제공할지 여부와 잘못된 인코딩이 검색되었을 때 예외를 발생시킬지 여부를 지정할 수 있습니다.Parameters specify whether to provide a Unicode byte order mark and whether to throw an exception when an invalid encoding is detected.

속성

BodyName

파생 클래스에서 재정의되면 메일 에이전트 본문 태그에 사용할 수 있는 현재 인코딩의 이름을 가져옵니다.When overridden in a derived class, gets a name for the current encoding that can be used with mail agent body tags.

(다음에서 상속됨 Encoding)
CodePage

파생 클래스에서 재정의되면 현재 Encoding의 코드 페이지 식별자를 가져옵니다.When overridden in a derived class, gets the code page identifier of the current Encoding.

(다음에서 상속됨 Encoding)
DecoderFallback

현재 DecoderFallback 개체에 대한 Encoding 개체를 가져오거나 설정합니다.Gets or sets the DecoderFallback object for the current Encoding object.

(다음에서 상속됨 Encoding)
EncoderFallback

현재 EncoderFallback 개체에 대한 Encoding 개체를 가져오거나 설정합니다.Gets or sets the EncoderFallback object for the current Encoding object.

(다음에서 상속됨 Encoding)
EncodingName

파생 클래스에서 재정의되면 현재 인코딩에 대해 사람이 읽을 수 있는 설명을 가져옵니다.When overridden in a derived class, gets the human-readable description of the current encoding.

(다음에서 상속됨 Encoding)
HeaderName

파생 클래스에서 재정의되면 메일 에이전트 헤더 태그에 사용할 수 있는 현재 인코딩의 이름을 가져옵니다.When overridden in a derived class, gets a name for the current encoding that can be used with mail agent header tags.

(다음에서 상속됨 Encoding)
IsBrowserDisplay

파생 클래스에서 재정의되면 현재 인코딩을 브라우저 클라이언트가 내용을 표시하는 데 사용할 수 있는지를 나타내는 값을 가져옵니다.When overridden in a derived class, gets a value indicating whether the current encoding can be used by browser clients for displaying content.

(다음에서 상속됨 Encoding)
IsBrowserSave

파생 클래스에서 재정의되면 현재 인코딩을 브라우저 클라이언트가 내용을 저장하는 데 사용할 수 있는지를 나타내는 값을 가져옵니다.When overridden in a derived class, gets a value indicating whether the current encoding can be used by browser clients for saving content.

(다음에서 상속됨 Encoding)
IsMailNewsDisplay

파생 클래스에서 재정의되면 현재 인코딩을 메일 및 뉴스 클라이언트가 내용을 표시하는 데 사용할 수 있는지를 나타내는 값을 가져옵니다.When overridden in a derived class, gets a value indicating whether the current encoding can be used by mail and news clients for displaying content.

(다음에서 상속됨 Encoding)
IsMailNewsSave

파생 클래스에서 재정의되면 현재 인코딩을 메일 및 뉴스 클라이언트가 내용을 저장하는 데 사용할 수 있는지를 나타내는 값을 가져옵니다.When overridden in a derived class, gets a value indicating whether the current encoding can be used by mail and news clients for saving content.

(다음에서 상속됨 Encoding)
IsReadOnly

파생 클래스에서 재정의되면 현재 인코딩이 읽기 전용인지를 나타내는 값을 가져옵니다.When overridden in a derived class, gets a value indicating whether the current encoding is read-only.

(다음에서 상속됨 Encoding)
IsSingleByte

파생 클래스에서 재정의되면 현재 인코딩이 단일 바이트 코드 포인트를 사용하는지를 나타내는 값을 가져옵니다.When overridden in a derived class, gets a value indicating whether the current encoding uses single-byte code points.

(다음에서 상속됨 Encoding)
Preamble

개체가 하나를 제공하도록 구성된 경우 UTF-8 형식으로 인코딩된 유니코드 바이트 순서 표시를 가져옵니다.Gets a Unicode byte order mark encoded in UTF-8 format, if this object is configured to supply one.

Preamble

파생 클래스에서 재정의할 경우, 사용된 인코딩을 지정하는 바이트 시퀀스를 포함하는 범위를 반환합니다.When overridden in a derived class, returns a span containing the sequence of bytes that specifies the encoding used.

(다음에서 상속됨 Encoding)
WebName

파생 클래스에서 재정의되면 현재 인코딩에 대해 IANA(Internet Assigned Numbers Authority)에 등록된 이름을 가져옵니다.When overridden in a derived class, gets the name registered with the Internet Assigned Numbers Authority (IANA) for the current encoding.

(다음에서 상속됨 Encoding)
WindowsCodePage

파생 클래스에서 재정의되면 현재 인코딩과 가장 비슷한 Windows 운영 체제 코드 페이지를 가져옵니다.When overridden in a derived class, gets the Windows operating system code page that most closely corresponds to the current encoding.

(다음에서 상속됨 Encoding)

메서드

Clone()

파생 클래스에서 재정의되면 현재 Encoding 개체의 부분 복사본을 만듭니다.When overridden in a derived class, creates a shallow copy of the current Encoding object.

(다음에서 상속됨 Encoding)
Equals(Object)

지정한 개체와 현재 UTF8Encoding 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current UTF8Encoding object.

GetByteCount(Char*, Int32)

지정한 문자 포인터에서 시작되는 문자 집합을 인코딩할 경우 생성되는 바이트 수를 계산합니다.Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

GetByteCount(Char*, Int32)

파생 클래스에서 재정의되면 지정한 문자 포인터에서 시작하는 문자 집합을 인코딩하여 생성되는 바이트 수를 계산합니다.When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

(다음에서 상속됨 Encoding)
GetByteCount(Char[])

파생 클래스에서 재정의되면 지정한 문자 배열의 모든 문자를 인코딩하여 생성되는 바이트 수를 계산합니다.When overridden in a derived class, calculates the number of bytes produced by encoding all the characters in the specified character array.

(다음에서 상속됨 Encoding)
GetByteCount(Char[], Int32, Int32)

지정한 문자 배열의 문자 집합을 인코딩할 경우 생성되는 바이트 수를 계산합니다.Calculates the number of bytes produced by encoding a set of characters from the specified character array.

GetByteCount(ReadOnlySpan<Char>)

지정된 문자 범위를 인코딩하여 생성된 바이트 수를 계산합니다.Calculates the number of bytes produced by encoding the specified character span.

GetByteCount(ReadOnlySpan<Char>)

파생 클래스에서 재정의할 경우, 지정된 문자 범위의 문자를 인코딩하여 생성되는 바이트 수를 계산합니다.When overridden in a derived class, calculates the number of bytes produced by encoding the characters in the specified character span.

(다음에서 상속됨 Encoding)
GetByteCount(String)

지정된 String의 문자를 인코딩하여 생성된 바이트 수를 계산합니다.Calculates the number of bytes produced by encoding the characters in the specified String.

GetByteCount(String, Int32, Int32)

파생 클래스에서 재정의할 경우, 지정된 문자열의 문자 집합을 인코딩하여 생성되는 바이트 수를 계산합니다.When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters from the specified string.

(다음에서 상속됨 Encoding)
GetBytes(Char*, Int32, Byte*, Int32)

지정한 문자 포인터에서 시작하는 문자 집합을 지정한 바이트 포인터에서 시작하여 저장되는 바이트 시퀀스로 인코딩합니다.Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.

GetBytes(Char*, Int32, Byte*, Int32)

파생 클래스에서 재정의되면 지정한 문자 포인터에서 시작하는 문자 집합을 지정한 바이트 포인터에서 시작하여 저장되는 바이트 시퀀스로 인코딩합니다.When overridden in a derived class, encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.

(다음에서 상속됨 Encoding)
GetBytes(Char[])

파생 클래스에서 재정의되면 지정한 문자 배열의 모든 문자를 바이트 시퀀스로 인코딩합니다.When overridden in a derived class, encodes all the characters in the specified character array into a sequence of bytes.

(다음에서 상속됨 Encoding)
GetBytes(Char[], Int32, Int32)

파생 클래스에서 재정의되면 지정한 문자 배열의 문자 집합을 바이트 시퀀스로 인코딩합니다.When overridden in a derived class, encodes a set of characters from the specified character array into a sequence of bytes.

(다음에서 상속됨 Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)

지정한 문자 배열의 문자 집합을 지정한 바이트 배열로 인코딩합니다.Encodes a set of characters from the specified character array into the specified byte array.

GetBytes(ReadOnlySpan<Char>, Span<Byte>)

지정된 문자 범위를 지정된 바이트 범위로 인코딩합니다.Encodes the specified character span into the specified byte span.

GetBytes(ReadOnlySpan<Char>, Span<Byte>)

파생 클래스에서 재정의할 경우, 지정된 읽기 전용 범위의 문자 집합을 바이트 범위로 인코딩합니다.When overridden in a derived class, encodes into a span of bytes a set of characters from the specified read-only span.

(다음에서 상속됨 Encoding)
GetBytes(String)

지정한 String 개체의 문자를 바이트 시퀀스로 인코딩합니다.Encodes the characters in a specified String object into a sequence of bytes.

GetBytes(String)

파생 클래스에서 재정의되면 지정한 문자열의 모든 문자를 바이트 시퀀스로 인코딩합니다.When overridden in a derived class, encodes all the characters in the specified string into a sequence of bytes.

(다음에서 상속됨 Encoding)
GetBytes(String, Int32, Int32)

파생 클래스에서 재정의할 경우, 지정된 index에서 시작하여 지정한 문자열 내에서 count로 지정된 문자의 수를 바이트 배결로 인코딩합니다.When overridden in a derived class, encodes into an array of bytes the number of characters specified by count in the specified string, starting from the specified index.

(다음에서 상속됨 Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)

지정된 String의 문자 집합을 지정된 바이트 배열로 인코딩합니다.Encodes a set of characters from the specified String into the specified byte array.

GetCharCount(Byte*, Int32)

지정한 바이트 포인터에서 시작되는 바이트 시퀀스를 디코딩할 경우 생성되는 문자 수를 계산합니다.Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.

GetCharCount(Byte*, Int32)

파생 클래스에서 재정의되면 지정한 바이트 포인터에서 시작하는 바이트 시퀀스를 디코딩하여 생성되는 문자 수를 계산합니다.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.

(다음에서 상속됨 Encoding)
GetCharCount(Byte[])

파생 클래스에서 재정의되면 지정한 바이트 배열의 모든 바이트를 디코딩하여 생성되는 문자 수를 계산합니다.When overridden in a derived class, calculates the number of characters produced by decoding all the bytes in the specified byte array.

(다음에서 상속됨 Encoding)
GetCharCount(Byte[], Int32, Int32)

지정한 바이트 배열의 바이트 시퀀스를 디코딩할 경우 생성되는 문자 수를 계산합니다.Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.

GetCharCount(ReadOnlySpan<Byte>)

지정된 바이트 범위를 디코딩하여 생성되는 문자 수를 계산합니다.Calculates the number of characters produced by decoding the specified byte span.

GetCharCount(ReadOnlySpan<Byte>)

파생 클래스에서 재정의할 경우, 제공된 읽기 전용 바이트 범위를 디코딩하여 생성되는 문자 수를 계산합니다.When overridden in a derived class, calculates the number of characters produced by decoding the provided read-only byte span.

(다음에서 상속됨 Encoding)
GetChars(Byte*, Int32, Char*, Int32)

지정한 바이트 포인터에서 시작하는 바이트 시퀀스를 지정한 문자 포인터에서 시작하여 저장되는 문자 집합으로 디코딩합니다.Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.

GetChars(Byte*, Int32, Char*, Int32)

파생 클래스에서 재정의되면 지정한 바이트 포인터에서 시작하는 바이트 시퀀스를 지정한 문자 포인터에서 시작하여 저장되는 문자 집합으로 디코딩합니다.When overridden in a derived class, decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.

(다음에서 상속됨 Encoding)
GetChars(Byte[])

파생 클래스에서 재정의되면 지정한 바이트 배열의 모든 바이트를 문자 집합으로 디코딩합니다.When overridden in a derived class, decodes all the bytes in the specified byte array into a set of characters.

(다음에서 상속됨 Encoding)
GetChars(Byte[], Int32, Int32)

파생 클래스에서 재정의되면 지정한 바이트 배열의 바이트 시퀀스를 문자 집합으로 디코딩합니다.When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a set of characters.

(다음에서 상속됨 Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)

지정한 바이트 배열의 바이트 시퀀스를 지정한 문자 배열로 디코딩합니다.Decodes a sequence of bytes from the specified byte array into the specified character array.

GetChars(ReadOnlySpan<Byte>, Span<Char>)

지정된 바이트 범위를 지정된 문자 범위로 디코딩합니다.Decodes the specified byte span into the specified character span.

GetChars(ReadOnlySpan<Byte>, Span<Char>)

파생 클래스에서 재정의할 경우, 지정된 읽기 전용 바이트 범위의 모든 바이트를 문자 범위로 디코딩합니다.When overridden in a derived class, decodes all the bytes in the specified read-only byte span into a character span.

(다음에서 상속됨 Encoding)
GetDecoder()

UTF-8로 인코딩된 바이트 시퀀스를 유니코드 문자 시퀀스로 변환하는 디코더를 가져옵니다.Obtains a decoder that converts a UTF-8 encoded sequence of bytes into a sequence of Unicode characters.

GetEncoder()

유니코드 문자 시퀀스를 UTF-8로 인코딩된 바이트 시퀀스로 변환하는 인코더를 가져옵니다.Obtains an encoder that converts a sequence of Unicode characters into a UTF-8 encoded sequence of bytes.

GetHashCode()

현재 인스턴스의 해시 코드를 반환합니다.Returns the hash code for the current instance.

GetMaxByteCount(Int32)

지정한 수의 문자를 인코딩할 경우 생성되는 최대 바이트 수를 계산합니다.Calculates the maximum number of bytes produced by encoding the specified number of characters.

GetMaxCharCount(Int32)

지정한 수의 바이트를 디코딩할 경우 생성되는 최대 문자 수를 계산합니다.Calculates the maximum number of characters produced by decoding the specified number of bytes.

GetPreamble()

UTF8Encoding 인코딩 개체가 제공하도록 구성된 경우 UTF-8 형식으로 인코딩된 유니코드 바이트 순서 표시를 반환합니다.Returns a Unicode byte order mark encoded in UTF-8 format, if the UTF8Encoding encoding object is configured to supply one.

GetString(Byte*, Int32)

파생 클래스에서 재정의할 때 지정된 주소에서 시작하는 지정된 바이트 수를 문자열로 디코딩합니다.When overridden in a derived class, decodes a specified number of bytes starting at a specified address into a string.

(다음에서 상속됨 Encoding)
GetString(Byte[])

파생 클래스에서 재정의되면 지정한 바이트 배열의 모든 바이트를 문자열로 디코딩합니다.When overridden in a derived class, decodes all the bytes in the specified byte array into a string.

(다음에서 상속됨 Encoding)
GetString(Byte[], Int32, Int32)

바이트 배열의 바이트 범위를 문자열로 디코딩합니다.Decodes a range of bytes from a byte array into a string.

GetString(Byte[], Int32, Int32)

파생 클래스에서 재정의되면 지정한 바이트 배열의 바이트 시퀀스를 문자열로 디코딩합니다.When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a string.

(다음에서 상속됨 Encoding)
GetString(ReadOnlySpan<Byte>)

파생 클래스에서 재정의할 경우, 지정된 바이트 범위의 모든 바이트를 문자열로 디코딩합니다.When overridden in a derived class, decodes all the bytes in the specified byte span into a string.

(다음에서 상속됨 Encoding)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
IsAlwaysNormalized()

기본 정규화 형식을 사용하여 현재 인코딩이 항상 정규화되는지를 나타내는 값을 가져옵니다.Gets a value indicating whether the current encoding is always normalized, using the default normalization form.

(다음에서 상속됨 Encoding)
IsAlwaysNormalized(NormalizationForm)

파생 클래스에서 재정의되면 지정한 정규화 형식을 사용하여 현재 인코딩이 항상 정규화되는지를 나타내는 값을 가져옵니다.When overridden in a derived class, gets a value indicating whether the current encoding is always normalized, using the specified normalization form.

(다음에서 상속됨 Encoding)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

확장 메서드

GetBytes(Encoding, ReadOnlySequence<Char>)

지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>Byte 배열로 인코딩합니다.Encodes the specified ReadOnlySequence<T> into a Byte array using the specified Encoding.

GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)

지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>byte로 디코딩하고 결과를 writer에 씁니다.Decodes the specified ReadOnlySequence<T> to bytes using the specified Encoding and writes the result to writer.

GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)

지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>byte로 인코딩하고 결과를 bytes에 출력합니다.Encodes the specified ReadOnlySequence<T> to bytes using the specified Encoding and outputs the result to bytes.

GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)

지정된 Encoding을 사용하여 지정된 ReadOnlySpan<T>byte로 인코딩하고 결과를 writer에 씁니다.Encodes the specified ReadOnlySpan<T> to bytes using the specified Encoding and writes the result to writer.

GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)

지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>char로 디코딩하고 결과를 writer에 씁니다.Decodes the specified ReadOnlySequence<T> to chars using the specified Encoding and writes the result to writer.

GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)

지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>char로 디코딩하고 결과를 chars에 출력합니다.Decodes the specified ReadOnlySequence<T> to chars using the specified Encoding and outputs the result to chars.

GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)

지정된 Encoding을 사용하여 지정된 ReadOnlySpan<T>char로 디코딩하고 결과를 writer에 씁니다.Decodes the specified ReadOnlySpan<T> to chars using the specified Encoding and writes the result to writer.

GetString(Encoding, ReadOnlySequence<Byte>)

지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>String으로 디코딩합니다.Decodes the specified ReadOnlySequence<T> into a String using the specified Encoding.

적용 대상

추가 정보