Decoder 클래스

정의

인코딩된 바이트 시퀀스를 문자 집합으로 변환합니다.Converts a sequence of encoded bytes into a set of characters.

public ref class Decoder abstract
public abstract class Decoder
[System.Serializable]
public abstract class Decoder
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Decoder
type Decoder = class
[<System.Serializable>]
type Decoder = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Decoder = class
Public MustInherit Class Decoder
상속
Decoder
특성

예제

다음 예제에서는를 사용 Decoder 하 여 두 개의 서로 다른 바이트 배열을 문자 배열로 변환 하는 방법을 보여 줍니다.The following example demonstrates the use of a Decoder to convert two different byte arrays into a character array. 문자의 바이트 중 하나가 배열의 범위를 벗어났습니다.One of the character's bytes spans the arrays. 이는 StreamReader 스트림을 읽을 때 개체가 내부적으로 수행 하는 작업과 비슷합니다.This is similar to what a StreamReader object does internally when reading a stream.

using namespace System;
using namespace System::Text;
int 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.
   array<Byte>^bytes1 = {0x20,0x23,0xe2};
   array<Byte>^bytes2 = {0x98,0xa3};
   array<Char>^chars = gcnew array<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 );
   for ( UInt16 index(0); index < chars->Length; ++index )
   {
      Console::Write( "U+{0:X4}  ", static_cast<UInt16>(chars[ index ]) );

   }
}

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 .To obtain an instance of an implementation of the Decoder class, the application should use the GetDecoder method of an Encoding implementation.

GetCharCount메서드는 바이트 시퀀스를 디코딩하는 문자 수를 결정 하 고 GetChars 메서드는 실제 디코딩을 수행 합니다.The GetCharCount method determines how many characters result in decoding a sequence of bytes, and the GetChars method performs the actual decoding. 클래스에서 사용할 수 있는 이러한 방법에는 여러 가지 버전이 있습니다 Decoder .There are several versions of both of these methods available in the Decoder class. 자세한 내용은 Encoding.GetChars를 참조하세요.For more information, see Encoding.GetChars. Decoder개체는 또는 메서드에 대 한 연속 호출 사이에 상태 정보를 유지 GetChars Convert 하므로 블록을 확장 하는 바이트 시퀀스를 올바르게 디코딩할 수 있습니다.A Decoder object maintains state information between successive calls to GetChars or Convert methods so it can correctly decode byte sequences that span blocks. Decoder또한는 데이터 블록 끝에 후행 바이트를 보존 하 고 다음 디코딩 작업에서 후행 바이트를 사용 합니다.The Decoder also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. 따라서 GetDecoderGetEncoder 는 네트워크 전송 및 파일 작업에 유용 합니다. 이러한 작업은 대개 전체 데이터 스트림 대신 데이터 블록을 처리 하기 때문입니다.Therefore, GetDecoder and GetEncoder are useful for network transmission and file operations because those operations often deal with blocks of data instead of a complete data stream.

참고

애플리케이션 데이터의 스트림을 사용 하 여 완료 되 면 상태 정보를 설정 하 여 플러시 되도록 확인 해야 합니다 flush 매개 변수를 true 적절 한 메서드 호출에서 합니다.When the application is done with a stream of data, it should make sure that the state information is flushed by setting the flush parameter to true in the appropriate method call. 예외가 발생 하거나 애플리케이션 스트림 전환 하는 경우 호출 해야 하는 경우 Reset 의 내부 상태를 지울지를 Decoder 개체입니다.If an exception occurs or if the application switches streams, it should call Reset to clear the internal state of the Decoder object.

버전 고려 사항Version Considerations

Decoder Encoder 변환 작업 중에 또는 개체를 serialize 할 수 있습니다.A Decoder or Encoder object can be serialized during a conversion operation. 개체의 상태는 동일한 버전의 .NET Framework에서 deserialize 되었지만 다른 버전에서 deserialize 된 경우에도 유지 됩니다.The state of the object is retained if it is deserialized in the same version of the .NET Framework, but lost if it is deserialized in another version.

구현자 참고

애플리케이션이 클래스에서 상속 하는 경우에 모든 멤버를 재정의 해야 합니다.When your application inherits from this class, it must override all the members.

생성자

Decoder()

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

속성

Fallback

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

FallbackBuffer

현재 DecoderFallbackBuffer 개체와 관련된 Decoder 개체를 가져옵니다.Gets the DecoderFallbackBuffer object associated with the current Decoder object.

메서드

Convert(Byte*, Int32, Char*, Int32, Boolean, Int32, Int32, Boolean)

인코딩된 바이트 버퍼를 UTF-16으로 인코딩된 문자로 변환하고 그 결과를 다른 버퍼에 저장합니다.Converts a buffer of encoded bytes to UTF-16 encoded characters and stores the result in another buffer.

Convert(Byte[], Int32, Int32, Char[], Int32, Int32, Boolean, Int32, Int32, Boolean)

인코딩된 바이트 배열을 UTF-16으로 인코딩된 문자로 변환하고 그 결과를 문자 배열에 저장합니다.Converts an array of encoded bytes to UTF-16 encoded characters and stores the result in a character array.

Convert(ReadOnlySpan<Byte>, Span<Char>, Boolean, Int32, Int32, Boolean)

인코딩된 바이트 범위를 UTF-16 인코딩 문자로 변환하고, 그 결과를 다른 범위 버퍼에 저장합니다.Converts a span of encoded bytes to UTF-16 encoded characters and stores the result in another span buffer.

Equals(Object)

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

(다음에서 상속됨 Object)
GetCharCount(Byte*, Int32, Boolean)

파생 클래스에서 재정의되면 지정한 바이트 포인터에서 시작하는 바이트 시퀀스를 디코딩하여 생성되는 문자 수를 계산합니다.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer. 매개 변수는 계산 후 디코더의 내부 상태를 지울지 여부를 나타냅니다.A parameter indicates whether to clear the internal state of the decoder after the calculation.

GetCharCount(Byte[], Int32, Int32)

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

GetCharCount(Byte[], Int32, Int32, Boolean)

파생 클래스에서 재정의되면 지정한 바이트 배열의 바이트 시퀀스를 디코딩하여 생성되는 문자 수를 계산합니다.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array. 매개 변수는 계산 후 디코더의 내부 상태를 지울지 여부를 나타냅니다.A parameter indicates whether to clear the internal state of the decoder after the calculation.

GetCharCount(ReadOnlySpan<Byte>, Boolean)

파생 클래스에서 재정의할 경우, 범위 내의 바이트 시퀀스를 디코딩 하여 생성되는 문자 수를 계산합니다.When overridden in a derived class, calculates the number of characters produced by decoding the sequence of bytes in the span. 매개 변수는 계산 후 디코더의 내부 상태를 지울지 여부를 나타냅니다.A parameter indicates whether to clear the internal state of the decoder after the calculation.

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

파생 클래스에서 재정의될 때 지정한 바이트 포인터에서 시작하는 바이트 시퀀스 및 내부 버퍼의 모든 바이트를 지정한 문자 포인터에서 시작하여 저장되는 문자 집합으로 디코딩합니다.When overridden in a derived class, decodes a sequence of bytes starting at the specified byte pointer and any bytes in the internal buffer into a set of characters that are stored starting at the specified character pointer. 매개 변수는 변환 후 디코더의 내부 상태를 지울지 여부를 나타냅니다.A parameter indicates whether to clear the internal state of the decoder after the conversion.

GetChars(Byte[], Int32, Int32, Char[], Int32)

파생 클래스에서 재정의될 때 지정한 바이트 배열의 바이트 시퀀스 및 내부 버퍼의 모든 바이트를 지정한 문자 배열로 디코딩합니다.When overridden in a derived class, decodes a sequence of bytes from the specified byte array and any bytes in the internal buffer into the specified character array.

GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)

파생 클래스에서 재정의될 때 지정한 바이트 배열의 바이트 시퀀스 및 내부 버퍼의 모든 바이트를 지정한 문자 배열로 디코딩합니다.When overridden in a derived class, decodes a sequence of bytes from the specified byte array and any bytes in the internal buffer into the specified character array. 매개 변수는 변환 후 디코더의 내부 상태를 지울지 여부를 나타냅니다.A parameter indicates whether to clear the internal state of the decoder after the conversion.

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

파생 클래스에서 재정의할 경우, 범위 바이트 시퀀스와 내부 버퍼의 모든 바이트를 지정된 문자 포인터에서 시작하여 저장되는 문자 집합으로 디코딩합니다.When overridden in a derived class, decodes a sequence of span bytes and any bytes in the internal buffer into a set of characters that are stored starting at the specified character pointer. 매개 변수는 변환 후 디코더의 내부 상태를 지울지 여부를 나타냅니다.A parameter indicates whether to clear the internal state of the decoder after the conversion.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

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

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

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

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

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

파생 클래스에서 재정의될 때 디코더를 다시 초기 상태로 설정합니다.When overridden in a derived class, sets the decoder back to its initial state.

ToString()

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

(다음에서 상속됨 Object)

확장 메서드

Convert(Decoder, ReadOnlySequence<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean)

ReadOnlySequence<T>을 UTF-16으로 인코딩된 문자로 변환하고 결과를 writer에 씁니다.Converts a ReadOnlySequence<T> to UTF-16 encoded characters and writes the result to writer.

Convert(Decoder, ReadOnlySpan<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean)

decoder를 사용하여 ReadOnlySpan<T>을 문자로 변환하고 결과를 writer에 씁니다.Converts a ReadOnlySpan<T> to chars using decoder and writes the result to writer.

적용 대상

추가 정보