Decoder 클래스

정의

네임스페이스:

System.Text

어셈블리:

mscorlib.dll

인코딩된 바이트 시퀀스를 문자 집합으로 변환합니다.

public ref class Decoder abstract

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Decoder

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Decoder = class

Public MustInherit Class Decoder

상속

Object

Decoder

특성

SerializableAttribute ComVisibleAttribute

예제

다음 예제에서는 두 개의 서로 다른 바이트 배열을 문자 배열로 변환하는 데 사용하는 Decoder 방법을 보여 줍니다. 문자의 바이트 중 하나가 배열에 걸쳐 있습니다. 이는 스트림을 읽을 때 개체가 StreamReader 내부적으로 수행하는 작업과 유사합니다.

using System;
using System.Text;
public class dec
{
    public static void Main()
    {
        // These bytes in UTF-8 correspond to 3 different Unicode
        // characters: space (U+0020), # (U+0023), and the biohazard
        // symbol (U+2623).  Note the biohazard symbol requires 3 bytes
        // in UTF-8 (hexadecimal e2, 98, a3).  Decoders store state across
        // multiple calls to GetChars, handling the case when one char
        // is in multiple byte arrays.
        byte[] bytes1 = { 0x20, 0x23, 0xe2 };
        byte[] bytes2 = { 0x98, 0xa3 };
        char[] chars = new char[3];

        Decoder d = Encoding.UTF8.GetDecoder();
        int charLen = d.GetChars(bytes1, 0, bytes1.Length, chars, 0);
        // The value of charLen should be 2 now.
        charLen += d.GetChars(bytes2, 0, bytes2.Length, chars, charLen);
        foreach(char c in chars)
            Console.Write("U+{0:X4}  ", (ushort)c);
    }
}

Imports System.Text

Public Class dec
    
    Public Shared Sub Main()
        ' These bytes in UTF-8 correspond to 3 different Unicode
        ' characters: space (U+0020), # (U+0023), and the biohazard
        ' symbol (U+2623).  Note the biohazard symbol requires 3 bytes
        ' in UTF-8 (hexadecimal e2, 98, a3).  Decoders store state across
        ' multiple calls to GetChars, handling the case when one char
        ' is in multiple byte arrays.
        Dim bytes1 As Byte() =  {&H20, &H23, &HE2}
        Dim bytes2 As Byte() =  {&H98, &HA3}
        Dim chars(3) As Char
        
        Dim d As Decoder = Encoding.UTF8.GetDecoder()
        Dim charLen As Integer = d.GetChars(bytes1, 0, bytes1.Length, chars, 0)
        ' The value of charLen should be 2 now.
        charLen += d.GetChars(bytes2, 0, bytes2.Length, chars, charLen)
        Dim c As Char
        For Each c In  chars
            Console.Write("U+{0:X4}  ", Convert.ToUInt16(c) )
        Next c
    End Sub
End Class

설명

클래스 구현의 인스턴스를 Decoder 가져오려면 구현 메서드를 GetDecoder 호출합니다 Encoding .

메서드는 GetCharCount 바이트 시퀀스를 디코딩할 수 있는 문자 수를 결정하고 메서드는 GetChars 실제 디코딩을 수행합니다. 클래스에서 사용할 수 있는 이러한 두 메서드의 여러 버전이 Decoder 있습니다. 자세한 내용은 Encoding.GetChars를 참조하세요. 개체는 Decoder 블록에 걸쳐 있는 바이트 시퀀스를 올바르게 디코딩할 GetChars 수 있도록 후속 호출 또는 Convert 메서드 간에 상태 정보를 유지 관리합니다. Decoder 또한 데이터 블록의 끝에 후행 바이트를 유지하고 다음 디코딩 작업에서 후행 바이트를 사용합니다. 따라서 GetDecoderGetEncoder 이러한 작업은 종종 전체 데이터 스트림 대신 데이터 블록을 처리하기 때문에 네트워크 전송 및 파일 작업에 유용합니다.

메모

애플리케이션이 데이터 스트림으로 완료되면 매개 변수 true 를 적절한 메서드 호출로 설정 flush 하여 상태 정보가 플러시되는지 확인해야 합니다. 예외가 발생하거나 애플리케이션이 스트림을 전환하는 경우 개체의 Decoder 내부 상태를 지우기 위해 호출 Reset 해야 합니다.

구현자 참고

애플리케이션이 이 클래스에서 상속되는 경우 모든 멤버를 재정의해야 합니다.

생성자

Name	Description
Decoder()	Decoder 클래스의 새 인스턴스를 초기화합니다.

속성

Name	Description
Fallback	현재 Decoder 개체의 개체를 DecoderFallback 가져오거나 설정합니다.
FallbackBuffer	DecoderFallbackBuffer 현재 Decoder 개체와 연결된 개체를 가져옵니다.

메서드

Name	Description
Convert(Byte[], Int32, Int32, Char[], Int32, Int32, Boolean, Int32, Int32, Boolean)	인코딩된 바이트 배열을 UTF-16으로 인코딩된 문자로 변환하고 결과를 문자 배열에 저장합니다.
Convert(Byte*, Int32, Char*, Int32, Boolean, Int32, Int32, Boolean)	인코딩된 바이트의 버퍼를 UTF-16으로 인코딩된 문자로 변환하고 결과를 다른 버퍼에 저장합니다.
Equals(Object)	지정한 개체와 현재 개체가 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
GetCharCount(Byte[], Int32, Int32, Boolean)	파생 클래스에서 재정의되는 경우 지정된 바이트 배열에서 바이트 시퀀스를 디코딩하여 생성된 문자 수를 계산합니다. 매개 변수는 계산 후 디코더의 내부 상태를 지울지 여부를 나타냅니다.
GetCharCount(Byte[], Int32, Int32)	파생 클래스에서 재정의되는 경우 지정된 바이트 배열에서 바이트 시퀀스를 디코딩하여 생성된 문자 수를 계산합니다.
GetCharCount(Byte*, Int32, Boolean)	파생 클래스에서 재정의되는 경우 지정된 바이트 포인터에서 시작하는 바이트 시퀀스를 디코딩하여 생성된 문자 수를 계산합니다. 매개 변수는 계산 후 디코더의 내부 상태를 지울지 여부를 나타냅니다.
GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)	파생 클래스에서 재정의되는 경우 지정된 바이트 배열의 바이트 시퀀스와 내부 버퍼의 바이트를 지정된 문자 배열로 디코딩합니다. 매개 변수는 변환 후 디코더의 내부 상태를 지울지 여부를 나타냅니다.
GetChars(Byte[], Int32, Int32, Char[], Int32)	파생 클래스에서 재정의되는 경우 지정된 바이트 배열의 바이트 시퀀스와 내부 버퍼의 바이트를 지정된 문자 배열로 디코딩합니다.
GetChars(Byte*, Int32, Char*, Int32, Boolean)	파생 클래스에서 재정의되는 경우 지정된 바이트 포인터에서 시작하는 바이트 시퀀스와 내부 버퍼의 바이트를 지정된 문자 포인터에서 시작하여 저장되는 문자 집합으로 디코딩합니다. 매개 변수는 변환 후 디코더의 내부 상태를 지울지 여부를 나타냅니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
Reset()	파생 클래스에서 재정의되는 경우 디코더를 초기 상태로 다시 설정합니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

추가 정보

• Encoder
• Encoding
• GetChars(Byte[], Int32, Int32)
• 인코딩 이해