ASCIIEncoding 클래스

정의

네임스페이스:

System.Text

어셈블리:

System.Text.Encoding.Extensions.dll

Source:

ASCIIEncoding.cs

유니코드 문자의 ASCII 문자 인코딩을 나타냅니다.

public ref class ASCIIEncoding : System::Text::Encoding

public class ASCIIEncoding : System.Text.Encoding

type ASCIIEncoding = class
    inherit Encoding

Public Class ASCIIEncoding
Inherits Encoding

상속

Object

Encoding

ASCIIEncoding

예제

다음 예제에서는 유니코드 문자를 ASCII로 인코딩하는 방법을 보여 줍니다. 애플리케이션에서 사용 하는 경우 발생 하는 데이터 손실 확인 ASCIIEncoding ASCII 범위 밖의 유니코드 문자를 인코딩합니다.

using namespace System;
using namespace System::Collections;
using namespace System::Text;
int main()
{
   
   // The encoding.
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   
   // A Unicode string with two characters outside the ASCII code range.
   String^ unicodeString = L"This Unicode String* contains two characters with codes outside the ASCII code range, Pi (\u03a0) and Sigma (\u03a3).";
   Console::WriteLine( "Original String*:" );
   Console::WriteLine( unicodeString );
   
   // Save positions of the special characters for later reference.
   int indexOfPi = unicodeString->IndexOf( L'\u03a0' );
   int indexOfSigma = unicodeString->IndexOf( L'\u03a3' );
   
   // Encode string.
   array<Byte>^encodedBytes = ascii->GetBytes( unicodeString );
   Console::WriteLine();
   Console::WriteLine( "Encoded bytes:" );
   IEnumerator^ myEnum = encodedBytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "->Item[ {0}]", b );
   }

   Console::WriteLine();
   
   // Notice that the special characters have been replaced with
   // the value 63, which is the ASCII character code for '?'.
   Console::WriteLine();
   Console::WriteLine( "Value at position of Pi character: {0}", encodedBytes[ indexOfPi ] );
   Console::WriteLine( "Value at position of Sigma character: {0}", encodedBytes[ indexOfSigma ] );
   
   // Decode bytes back to string.
   // Notice missing Pi and Sigma characters.
   String^ decodedString = ascii->GetString( encodedBytes );
   Console::WriteLine();
   Console::WriteLine( "Decoded bytes:" );
   Console::WriteLine( decodedString );
}
// The example displays the following output:
//    Original string:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (Π) and Sigma (Σ).
//
//    Encoded bytes:
//    [84][104][105][115][32][85][110][105][99][111][100][101][32][115][116][114][105]
//    [110][103][32][99][111][110][116][97][105][110][115][32][116][119][111][32][99][
//    104][97][114][97][99][116][101][114][115][32][119][105][116][104][32][99][111][1
//    00][101][115][32][111][117][116][115][105][100][101][32][116][104][101][32][65][
//    83][67][73][73][32][99][111][100][101][32][114][97][110][103][101][44][32][80][1
//    05][32][40][63][41][32][97][110][100][32][83][105][103][109][97][32][40][63][41]
//    [46]
//
//    Value at position of Pi character: 63
//    Value at position of Sigma character: 63
//
//    Decoded bytes:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (?) and Sigma (?).

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        // The encoding.
        ASCIIEncoding ascii = new ASCIIEncoding();
        
        // A Unicode string with two characters outside the ASCII code range.
        String unicodeString =
            "This Unicode string contains two characters " +
            "with codes outside the ASCII code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Save positions of the special characters for later reference.
        int indexOfPi = unicodeString.IndexOf('\u03a0');
        int indexOfSigma = unicodeString.IndexOf('\u03a3');

        // Encode string.
        Byte[] encodedBytes = ascii.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
        
        // Notice that the special characters have been replaced with
        // the value 63, which is the ASCII character code for '?'.
        Console.WriteLine();
        Console.WriteLine(
            "Value at position of Pi character: {0}",
            encodedBytes[indexOfPi]
        );
        Console.WriteLine(
            "Value at position of Sigma character: {0}",
            encodedBytes[indexOfSigma]
        );

        // Decode bytes back to string.
        // Notice missing Pi and Sigma characters.
        String decodedString = ascii.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}
// The example displays the following output:
//    Original string:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (Π) and Sigma (Σ).
//
//    Encoded bytes:
//    [84][104][105][115][32][85][110][105][99][111][100][101][32][115][116][114][105]
//    [110][103][32][99][111][110][116][97][105][110][115][32][116][119][111][32][99][
//    104][97][114][97][99][116][101][114][115][32][119][105][116][104][32][99][111][1
//    00][101][115][32][111][117][116][115][105][100][101][32][116][104][101][32][65][
//    83][67][73][73][32][99][111][100][101][32][114][97][110][103][101][44][32][80][1
//    05][32][40][63][41][32][97][110][100][32][83][105][103][109][97][32][40][63][41]
//    [46]
//
//    Value at position of Pi character: 63
//    Value at position of Sigma character: 63
//
//    Decoded bytes:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (?) and Sigma (?).

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        ' The encoding.
        Dim ascii As New ASCIIEncoding()

        ' A Unicode string with two characters outside the ASCII code range.
        Dim unicodeString As String = _
            "This Unicode string contains two characters " & _
            "with codes outside the ASCII code range, " & _
            "Pi (" & ChrW(928) & ") and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)

        ' Save positions of the special characters for later reference.
        Dim indexOfPi As Integer = unicodeString.IndexOf(ChrW(928))
        Dim indexOfSigma As Integer = unicodeString.IndexOf(ChrW(931))

        ' Encode string.
        Dim encodedBytes As Byte() = ascii.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Dim b As Byte
        For Each b In encodedBytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()

        ' Notice that the special characters have been replaced with
        ' the value 63, which is the ASCII character code for '?'.
        Console.WriteLine()
        Console.WriteLine( _
            "Value at position of Pi character: {0}", _
            encodedBytes(indexOfPi) _
        )
        Console.WriteLine( _
            "Value at position of Sigma character: {0}", _
            encodedBytes(indexOfSigma) _
        )

        ' Decode bytes back to string.
        ' Notice missing Pi and Sigma characters.
        Dim decodedString As String = ascii.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 contains two characters with codes outside the ASCII code ra
'    nge, Pi (Π) and Sigma (Σ).
'
'    Encoded bytes:
'    [84][104][105][115][32][85][110][105][99][111][100][101][32][115][116][114][105]
'    [110][103][32][99][111][110][116][97][105][110][115][32][116][119][111][32][99][
'    104][97][114][97][99][116][101][114][115][32][119][105][116][104][32][99][111][1
'    00][101][115][32][111][117][116][115][105][100][101][32][116][104][101][32][65][
'    83][67][73][73][32][99][111][100][101][32][114][97][110][103][101][44][32][80][1
'    05][32][40][63][41][32][97][110][100][32][83][105][103][109][97][32][40][63][41]
'    [46]
'
'    Value at position of Pi character: 63
'    Value at position of Sigma character: 63
'
'    Decoded bytes:
'    This Unicode string contains two characters with codes outside the ASCII code ra
'    nge, Pi (?) and Sigma (?).

설명

인코딩은 유니코드 문자 집합을 바이트 시퀀스로 변환하는 프로세스입니다. 디코딩은 인코딩된 바이트 시퀀스를 유니코드 문자 집합으로 변환하는 프로세스입니다.

ASCIIEncoding 는 Windows 코드 페이지 20127에 해당합니다. ASCII는 7비트 인코딩이므로 ASCII 문자는 U+0000에서 U+007F까지 가장 낮은 128개 유니코드 문자로 제한됩니다. 속성 또는 ASCIIEncoding 생성자가 반환하는 Encoding.ASCII 기본 인코더를 사용하는 경우 인코딩 작업이 수행되기 전에 해당 범위 밖의 문자가 물음표(?)로 바뀝니다. 때문에 합니다 ASCIIEncoding 클래스는 제한 된 문자 집합만 지원 합니다 UTF8Encoding, UnicodeEncoding, 및 UTF32Encoding 클래스는 세계화 된 애플리케이션에 적합 한 더 합니다. 다음 고려 사항은 를 사용할 ASCIIEncoding지 여부를 결정하는 데 도움이 될 수 있습니다.

• 일부 프로토콜에는 ASCII 또는 ASCII의 하위 집합이 필요합니다. 이러한 경우 ASCII 인코딩이 적절합니다.

• 8비트 인코딩이 필요한 경우 ASCII가 올바른 선택이 아닐 수 있습니다. 대신 ASCII 대신 UTF8을 사용하는 것이 좋습니다. U+0000~U+007F 문자의 경우 결과는 동일하지만 모든 유니코드 문자는 UTF-8로 표시되어 데이터 손실을 방지합니다.

주의

ASCIIEncoding 는 오류 검색을 제공하지 않습니다. 보안상의 이유로 , UnicodeEncoding또는 UTF32Encoding 을 사용하고 UTF8Encoding오류 검색을 사용하도록 설정해야 합니다.

GetByteCount메서드는 유니코드 문자 집합을 인코딩할 바이트 수를 결정 하 고 GetBytes 메서드는 실제 인코딩을 수행 합니다.

마찬가지로 메서드는 GetCharCount 바이트 GetChars 시퀀스를 디코딩하는 결과 문자 수를 결정하고 및 GetString 메서드는 실제 디코딩을 수행합니다.

기본 ASCIIEncoding 생성자 자체 애플리케이션에 대 한 적절 한 동작에 없을 수 있습니다. 또는 속성을 EncoderExceptionFallback 또는 DecoderFallbackDecoderExceptionFallback 로 설정 EncoderFallback 하여 8번째 비트가 설정된 시퀀스를 방지하는 것이 좋습니다. 사용자 지정 동작은 이러한 경우에 적합할 수도 있습니다.

생성자

ASCIIEncoding()

ASCIIEncoding 클래스의 새 인스턴스를 초기화합니다.

속성

BodyName	파생 클래스에서 재정의되면 메일 에이전트 본문 태그에 사용할 수 있는 현재 인코딩의 이름을 가져옵니다. (다음에서 상속됨 Encoding)
CodePage	파생 클래스에서 재정의되면 현재 Encoding의 코드 페이지 식별자를 가져옵니다. (다음에서 상속됨 Encoding)
DecoderFallback	현재 DecoderFallback 개체에 대한 Encoding 개체를 가져오거나 설정합니다. (다음에서 상속됨 Encoding)
EncoderFallback	현재 EncoderFallback 개체에 대한 Encoding 개체를 가져오거나 설정합니다. (다음에서 상속됨 Encoding)
EncodingName	파생 클래스에서 재정의되면 현재 인코딩에 대해 사람이 읽을 수 있는 설명을 가져옵니다. (다음에서 상속됨 Encoding)
HeaderName	파생 클래스에서 재정의되면 메일 에이전트 헤더 태그에 사용할 수 있는 현재 인코딩의 이름을 가져옵니다. (다음에서 상속됨 Encoding)
IsBrowserDisplay	파생 클래스에서 재정의되면 현재 인코딩을 브라우저 클라이언트가 내용을 표시하는 데 사용할 수 있는지를 나타내는 값을 가져옵니다. (다음에서 상속됨 Encoding)
IsBrowserSave	파생 클래스에서 재정의되면 현재 인코딩을 브라우저 클라이언트가 내용을 저장하는 데 사용할 수 있는지를 나타내는 값을 가져옵니다. (다음에서 상속됨 Encoding)
IsMailNewsDisplay	파생 클래스에서 재정의되면 현재 인코딩을 메일 및 뉴스 클라이언트가 내용을 표시하는 데 사용할 수 있는지를 나타내는 값을 가져옵니다. (다음에서 상속됨 Encoding)
IsMailNewsSave	파생 클래스에서 재정의되면 현재 인코딩을 메일 및 뉴스 클라이언트가 내용을 저장하는 데 사용할 수 있는지를 나타내는 값을 가져옵니다. (다음에서 상속됨 Encoding)
IsReadOnly	파생 클래스에서 재정의되면 현재 인코딩이 읽기 전용인지를 나타내는 값을 가져옵니다. (다음에서 상속됨 Encoding)
IsSingleByte	현재 인코딩이 싱글바이트 코드 포인트를 사용하는지 여부를 나타내는 값을 가져옵니다.
Preamble	파생 클래스에서 재정의할 경우, 사용된 인코딩을 지정하는 바이트 시퀀스를 포함하는 범위를 반환합니다. (다음에서 상속됨 Encoding)
WebName	파생 클래스에서 재정의되면 현재 인코딩에 대해 IANA(Internet Assigned Numbers Authority)에 등록된 이름을 가져옵니다. (다음에서 상속됨 Encoding)
WindowsCodePage	파생 클래스에서 재정의되면 현재 인코딩과 가장 비슷한 Windows 운영 체제 코드 페이지를 가져옵니다. (다음에서 상속됨 Encoding)

메서드

Clone()	파생 클래스에서 재정의되면 현재 Encoding 개체의 부분 복사본을 만듭니다. (다음에서 상속됨 Encoding)
Equals(Object)	지정한 Object가 현재 인스턴스와 같은지를 확인합니다. (다음에서 상속됨 Encoding)
GetByteCount(Char*, Int32)	지정한 문자 포인터에서 시작되는 문자 집합을 인코딩할 경우 생성되는 바이트 수를 계산합니다.
GetByteCount(Char[])	파생 클래스에서 재정의되면 지정한 문자 배열의 모든 문자를 인코딩하여 생성되는 바이트 수를 계산합니다. (다음에서 상속됨 Encoding)
GetByteCount(Char[], Int32, Int32)	지정한 문자 배열의 문자 집합을 인코딩할 경우 생성되는 바이트 수를 계산합니다.
GetByteCount(ReadOnlySpan<Char>)	지정된 문자 범위를 인코딩하여 생성된 바이트 수를 계산합니다.
GetByteCount(String)	지정된 String의 문자를 인코딩하여 생성된 바이트 수를 계산합니다.
GetByteCount(String, Int32, Int32)	파생 클래스에서 재정의할 경우, 지정된 문자열의 문자 집합을 인코딩하여 생성되는 바이트 수를 계산합니다. (다음에서 상속됨 Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	지정한 문자 포인터에서 시작하는 문자 집합을 지정한 바이트 포인터에서 시작하여 저장되는 바이트 시퀀스로 인코딩합니다.
GetBytes(Char[])	파생 클래스에서 재정의되면 지정한 문자 배열의 모든 문자를 바이트 시퀀스로 인코딩합니다. (다음에서 상속됨 Encoding)
GetBytes(Char[], Int32, Int32)	파생 클래스에서 재정의되면 지정한 문자 배열의 문자 집합을 바이트 시퀀스로 인코딩합니다. (다음에서 상속됨 Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	지정한 문자 배열의 문자 집합을 지정한 바이트 배열로 인코딩합니다.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	지정된 문자 범위를 지정된 바이트 범위로 인코딩합니다.
GetBytes(String)	파생 클래스에서 재정의되면 지정한 문자열의 모든 문자를 바이트 시퀀스로 인코딩합니다. (다음에서 상속됨 Encoding)
GetBytes(String, Int32, Int32)	파생 클래스에서 재정의할 경우, 지정된 index에서 시작하여 지정한 문자열 내에서 count로 지정된 문자의 수를 바이트 배결로 인코딩합니다. (다음에서 상속됨 Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	지정된 String의 문자 집합을 지정된 바이트 배열로 인코딩합니다.
GetCharCount(Byte*, Int32)	지정한 바이트 포인터에서 시작되는 바이트 시퀀스를 디코딩할 경우 생성되는 문자 수를 계산합니다.
GetCharCount(Byte[])	파생 클래스에서 재정의되면 지정한 바이트 배열의 모든 바이트를 디코딩하여 생성되는 문자 수를 계산합니다. (다음에서 상속됨 Encoding)
GetCharCount(Byte[], Int32, Int32)	지정한 바이트 배열의 바이트 시퀀스를 디코딩할 경우 생성되는 문자 수를 계산합니다.
GetCharCount(ReadOnlySpan<Byte>)	지정된 바이트 범위를 디코딩하여 생성되는 문자 수를 계산합니다.
GetChars(Byte*, Int32, Char*, Int32)	지정한 바이트 포인터에서 시작하는 바이트 시퀀스를 지정한 문자 포인터에서 시작하여 저장되는 문자 집합으로 디코딩합니다.
GetChars(Byte[])	파생 클래스에서 재정의되면 지정한 바이트 배열의 모든 바이트를 문자 집합으로 디코딩합니다. (다음에서 상속됨 Encoding)
GetChars(Byte[], Int32, Int32)	파생 클래스에서 재정의되면 지정한 바이트 배열의 바이트 시퀀스를 문자 집합으로 디코딩합니다. (다음에서 상속됨 Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	지정한 바이트 배열의 바이트 시퀀스를 지정한 문자 배열로 디코딩합니다.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	지정된 바이트 범위를 지정된 문자 범위로 디코딩합니다.
GetDecoder()	ASCII로 인코딩된 바이트 시퀀스를 유니코드 문자 시퀀스로 변환하는 디코더를 가져옵니다.
GetEncoder()	유니코드 문자 시퀀스를 ASCII로 인코딩된 바이트 시퀀스로 변환하는 인코더를 가져옵니다.
GetHashCode()	현재 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Encoding)
GetMaxByteCount(Int32)	지정한 수의 문자를 인코딩할 경우 생성되는 최대 바이트 수를 계산합니다.
GetMaxCharCount(Int32)	지정한 수의 바이트를 디코딩할 경우 생성되는 최대 문자 수를 계산합니다.
GetPreamble()	파생 클래스에서 재정의되면 사용되는 인코딩을 지정하는 바이트 시퀀스를 반환합니다. (다음에서 상속됨 Encoding)
GetString(Byte*, Int32)	파생 클래스에서 재정의할 때 지정된 주소에서 시작하는 지정된 바이트 수를 문자열로 디코딩합니다. (다음에서 상속됨 Encoding)
GetString(Byte[])	파생 클래스에서 재정의되면 지정한 바이트 배열의 모든 바이트를 문자열로 디코딩합니다. (다음에서 상속됨 Encoding)
GetString(Byte[], Int32, Int32)	바이트 배열의 바이트 범위를 문자열로 디코딩합니다.
GetString(ReadOnlySpan<Byte>)	파생 클래스에서 재정의할 경우, 지정된 바이트 범위의 모든 바이트를 문자열로 디코딩합니다. (다음에서 상속됨 Encoding)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
IsAlwaysNormalized()	기본 정규화 형식을 사용하여 현재 인코딩이 항상 정규화되는지를 나타내는 값을 가져옵니다. (다음에서 상속됨 Encoding)
IsAlwaysNormalized(NormalizationForm)	파생 클래스에서 재정의되면 지정한 정규화 형식을 사용하여 현재 인코딩이 항상 정규화되는지를 나타내는 값을 가져옵니다. (다음에서 상속됨 Encoding)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	대상이 충분히 큰 경우 지정된 읽기 전용 범위의 문자 집합을 바이트 범위로 인코딩합니다.
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	대상이 충분히 큰 경우 지정된 읽기 전용 범위에서 바이트 집합을 chars 범위로 디코딩합니다.

확장 메서드

GetBytes(Encoding, ReadOnlySequence<Char>)	지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>을 Byte 배열로 인코딩합니다.
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>을 byte로 디코딩하고 결과를 writer에 씁니다.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>을 byte로 인코딩하고 결과를 bytes에 출력합니다.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	지정된 Encoding을 사용하여 지정된 ReadOnlySpan<T>을 byte로 인코딩하고 결과를 writer에 씁니다.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>을 char로 디코딩하고 결과를 writer에 씁니다.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>을 char로 디코딩하고 결과를 chars에 출력합니다.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	지정된 Encoding을 사용하여 지정된 ReadOnlySpan<T>을 char로 디코딩하고 결과를 writer에 씁니다.
GetString(Encoding, ReadOnlySequence<Byte>)	지정된 Encoding을 사용하여 지정된 ReadOnlySequence<T>을 String으로 디코딩합니다.

추가 정보

• Decoder
• Encoder
• 인코딩 이해