EncodingProvider.GetEncoding 메서드

정의

네임스페이스:

System.Text

어셈블리:

System.Runtime.dll

인코딩을 반환합니다.

오버로드

GetEncoding(Int32)	지정한 코드 페이지 식별자와 관련된 인코딩을 반환합니다.
GetEncoding(String)	지정된 이름의 인코딩을 반환합니다.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	지정한 코드 페이지 식별자와 관련된 인코딩을 반환합니다. 매개 변수는 인코딩할 수 없는 문자 및 디코딩할 수 없는 바이트 시퀀스에 대한 오류 처리기를 지정합니다.
GetEncoding(String, EncoderFallback, DecoderFallback)	지정한 이름과 연결된 인코딩을 반환합니다. 매개 변수는 인코딩할 수 없는 문자 및 디코딩할 수 없는 바이트 시퀀스에 대한 오류 처리기를 지정합니다.

GetEncoding(Int32)

Source:

EncodingProvider.cs

지정한 코드 페이지 식별자와 관련된 인코딩을 반환합니다.

public:
 abstract System::Text::Encoding ^ GetEncoding(int codepage);

public abstract System.Text.Encoding? GetEncoding (int codepage);

abstract member GetEncoding : int -> System.Text.Encoding

Public MustOverride Function GetEncoding (codepage As Integer) As Encoding

매개 변수

codepage

Int32

요청한 인코딩의 코드 페이지 식별자입니다.

반환

Encoding

지정된 코드 페이지와 연결된 인코딩이거나 이 EncodingProvider가 codepage에 해당하는 올바른 인코딩을 반환할 수 없는 경우 null입니다.

설명

발신자에 대한 참고 사항

이 메서드는 Encoding.GetEncoding(Int32) 메서드를 통해 호출됩니다. 사용자 코드에서 직접 호출해서는 안 됩니다.

구현자 참고

서브클래스가 GetEncoding(Int32) 지원하는 인코딩 또는 인코딩을 반환하도록 메서드를 재정의합니다 EncodingProvider . 사용자 코드가 메서드를 호출 GetEncoding(Int32) 하여 인코딩을 검색하려고 하면 메서드는 유효한 인코딩을 반환할 때까지 등록된 모든 인코딩 공급자에게 식별자를 전달 codepage 합니다. 없음이 유효한 인코딩을 반환하지 않으면 메서드는 GetEncoding(Int32) 코드 페이지 식별자가 codepage인 캐시된 인코딩을 검색하려고 시도합니다. 이 때문에 가 지원하는 인코딩의 코드 페이지 식별자가 아닌 경우 codepage 메서드는 를 반환 null해야 합니다. 예외를 throw해서는 안 됩니다.

호출자 참고

이 메서드는 GetEncoding(Int32) 메서드. 사용자 코드에서 직접 호출해서는 안 됩니다.

추가 정보

• GetEncoding(Int32)

GetEncoding(String)

Source:

EncodingProvider.cs

지정된 이름의 인코딩을 반환합니다.

public:
 abstract System::Text::Encoding ^ GetEncoding(System::String ^ name);

public abstract System.Text.Encoding? GetEncoding (string name);

abstract member GetEncoding : string -> System.Text.Encoding

Public MustOverride Function GetEncoding (name As String) As Encoding

매개 변수

name

String

요청한 인코딩의 이름입니다.

반환

Encoding

지정된 이름과 연결된 인코딩이거나 이 EncodingProvider가 name에 해당하는 올바른 인코딩을 반환할 수 없는 경우 null입니다.

설명

상속자에 대한 참고 사항

하위 클래스에서 지원하는 인코딩 또는 인코딩을 반환하도록 GetEncoding(String) 메서드를 재정의합니다 EncodingProvider . 사용자 코드가 GetEncoding(String) 메서드를 호출하여 인코딩을 검색하려고 하면 메서드는 유효한 인코딩을 반환할 때까지 등록된 모든 인코딩 공급자에게 인수를 전달 name 합니다. 유효한 인코딩을 반환하지 않으면 GetEncoding(String) 메서드는 이름이 name인 캐시된 인코딩을 검색하려고 시도합니다. 이 때문에 가 지원하는 인코딩의 이름이 아닌 경우 name 메서드는 를 반환 null해야 합니다. 메서드가 예외를 throw해야 하는 유일한 경우는 이 인 경우 name 입니다 null.

발신자에 대한 참고 사항

이 메서드는 Encoding.GetEncoding(String) 메서드를 통해 호출됩니다. 사용자 코드에서 직접 호출해서는 안 됩니다.

구현자 참고

서브클래스가 GetEncoding(String) 지원하는 인코딩 또는 인코딩을 반환하도록 메서드를 재정의합니다 EncodingProvider . 사용자 코드가 메서드를 호출 GetEncoding(String) 하여 인코딩을 검색하려고 하면 메서드는 유효한 인코딩을 반환할 때까지 등록된 모든 인코딩 공급자에게 인수를 전달 name 합니다. 없음이 유효한 인코딩을 반환하지 않으면 메서드는 GetEncoding(String) 이름이 name인 캐시된 인코딩을 검색하려고 시도합니다. 이 때문에 가 지원하는 인코딩의 이름이 아닌 경우 name 메서드는 를 반환 null해야 합니다. 메서드가 예외를 throw해야 하는 유일한 경우는 이 인 경우 name 입니다 null.

호출자 참고

이 메서드는 GetEncoding(String) 메서드. 사용자 코드에서 직접 호출해서는 안 됩니다.

추가 정보

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Source:

EncodingProvider.cs

지정한 코드 페이지 식별자와 관련된 인코딩을 반환합니다. 매개 변수는 인코딩할 수 없는 문자 및 디코딩할 수 없는 바이트 시퀀스에 대한 오류 처리기를 지정합니다.

public:
 virtual System::Text::Encoding ^ GetEncoding(int codepage, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);

public virtual System.Text.Encoding? GetEncoding (int codepage, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);

abstract member GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding

Public Overridable Function GetEncoding (codepage As Integer, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

매개 변수

codepage

Int32

요청한 인코딩의 코드 페이지 식별자입니다.

encoderFallback

EncoderFallback

이 인코딩으로 문자를 인코딩할 수 없는 경우 오류 처리 프로시저를 제공하는 개체입니다.

decoderFallback

DecoderFallback

이 인코딩으로 바이트 시퀀스를 디코딩할 수 없는 경우 오류 처리 프로시저를 제공하는 개체입니다.

반환

Encoding

지정된 코드 페이지와 연결된 인코딩이거나 이 EncodingProvider가 codepage에 해당하는 올바른 인코딩을 반환할 수 없는 경우 null입니다.

설명

encoderFallback 및 decoderFallback 매개 변수는 인코더가 문자를 바이트 시퀀스로 변환할 수 없거나 디코더가 바이트 시퀀스를 문자로 변환할 수 없는 경우에 사용되는 대체 전략을 정의하는 개체입니다. .NET Framework 다음과 같은 대체 메커니즘을 제공합니다.

• 예외 대체 (fallback)입니다. 인수가 encoderFallback 의 instance EncoderExceptionFallback또는 decoderExceptionFallback 인수가 의 DecoderExceptionFallbackinstance 인 경우 인코딩 메서드는 문자를 인코딩할 수 없는 경우 예외를 throw하고 바이트 시퀀스를 디코딩할 수 없는 경우 디코딩 메서드가 예외를 throw합니다.

• 교체 대체 (fallback) 합니다. 인수가 encoderFallback 의 instance EncoderReplacementFallback또는 decoderExceptionFallback 인수가 의 DecoderReplacementFallbackinstance 인 경우 인코딩 및 디코딩 메서드는 인코딩할 수 없고 바이트 시퀀스를 디코딩할 수 없는 문자로 대체 문자열을 대체합니다. 매개 변수가 없는 생성자를 호출하여 대체 대체 개체를 인스턴스화한 경우 대체 문자는 "?"입니다. 또는 DecoderReplacementFallback.DecoderReplacementFallback(String) 생성자를 호출하는 EncoderReplacementFallback.EncoderReplacementFallback(String) 경우 대체 문자열을 지정할 수 있습니다.

• 최적된 대체 (fallback) 합니다. 또는 DecoderFallback 클래스에서 EncoderFallback 파생하여 가장 적합한 대체 메커니즘을 구현할 수 있습니다.

상속자 참고

이 메서드에 대한 호출은 메서드의 구현을 GetEncoding(Int32) 사용하므로 재정의할 필요가 없습니다. 사용자 코드가 메서드를 호출 GetEncoding(Int32, EncoderFallback, DecoderFallback) 하여 인코딩을 검색하려고 하면 메서드는 유효한 인코딩을 반환할 때까지 등록된 모든 인코딩 공급자에게 식별자를 전달 codepage 합니다. 없음이 유효한 인코딩을 반환하지 않으면 메서드는 GetEncoding(Int32) 코드 페이지 식별자가 codepage인 캐시된 인코딩을 검색하려고 시도합니다. 이 때문에 메서드를 재정 GetEncoding(Int32, EncoderFallback, DecoderFallback) 의하도록 선택하는 경우 가 지원하는 인코딩의 코드 페이지 식별자가 아닌 경우 codepage 재정의가 반환 null 되어야 합니다. 예외를 throw해서는 안 됩니다.

호출자 참고

이 메서드는 GetEncoding(Int32, EncoderFallback, DecoderFallback) 메서드. 사용자 코드에서 직접 호출해서는 안 됩니다.

추가 정보

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Source:

EncodingProvider.cs

지정한 이름과 연결된 인코딩을 반환합니다. 매개 변수는 인코딩할 수 없는 문자 및 디코딩할 수 없는 바이트 시퀀스에 대한 오류 처리기를 지정합니다.

public:
 virtual System::Text::Encoding ^ GetEncoding(System::String ^ name, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);

public virtual System.Text.Encoding? GetEncoding (string name, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);

abstract member GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding

Public Overridable Function GetEncoding (name As String, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

매개 변수

name

String

기본 설정 인코딩의 이름입니다.

encoderFallback

EncoderFallback

이 인코딩으로 문자를 인코딩할 수 없는 경우 오류 처리 프로시저를 제공하는 개체입니다.

decoderFallback

DecoderFallback

현재 인코딩으로 바이트 시퀀스를 디코딩할 수 없는 경우 오류 처리 프로시저를 제공하는 개체입니다.

반환

Encoding

지정된 이름과 연결된 인코딩이거나 이 EncodingProvider가 name에 해당하는 올바른 인코딩을 반환할 수 없는 경우 null입니다.

설명

encoderFallback 및 decoderFallback 매개 변수는 인코더가 문자를 바이트 시퀀스로 변환할 수 없거나 디코더가 바이트 시퀀스를 문자로 변환할 수 없는 경우에 사용되는 대체 전략을 정의하는 개체입니다. .NET Framework 다음과 같은 대체 메커니즘을 제공합니다.

• 예외 대체 (fallback)입니다. 인수가 encoderFallback 의 instance EncoderExceptionFallback또는 decoderExceptionFallback 인수가 의 DecoderExceptionFallbackinstance 인 경우 인코딩 메서드는 문자를 인코딩할 수 없는 경우 예외를 throw하고 바이트 시퀀스를 디코딩할 수 없는 경우 디코딩 메서드가 예외를 throw합니다.

• 교체 대체 (fallback) 합니다. 인수가 encoderFallback 의 instance EncoderReplacementFallback또는 decoderExceptionFallback 인수가 의 DecoderReplacementFallbackinstance 인 경우 인코딩 및 디코딩 메서드는 인코딩할 수 없고 바이트 시퀀스를 디코딩할 수 없는 문자로 대체 문자열을 대체합니다. 매개 변수가 없는 생성자를 호출하여 대체 대체 개체를 인스턴스화한 경우 대체 문자는 "?"입니다. 또는 DecoderReplacementFallback.DecoderReplacementFallback(String) 생성자를 호출하는 EncoderReplacementFallback.EncoderReplacementFallback(String) 경우 대체 문자열을 지정할 수 있습니다.

• 최적된 대체 (fallback) 합니다. 또는 DecoderFallback 클래스에서 EncoderFallback 파생하여 가장 적합한 대체 메커니즘을 구현할 수 있습니다.

상속자 참고

이 메서드에 대한 호출은 메서드의 구현을 GetEncoding(String) 사용하므로 재정의할 필요가 없습니다. 사용자 코드가 메서드를 호출 GetEncoding(String, EncoderFallback, DecoderFallback) 하여 인코딩을 검색하려고 하면 메서드는 유효한 인코딩을 반환할 때까지 등록된 모든 인코딩 공급자에게 식별자를 전달 codepage 합니다. 없음이 유효한 인코딩을 반환하지 않으면 메서드는 GetEncoding(Int32) 코드 페이지 식별자가 codepage인 캐시된 인코딩을 검색하려고 시도합니다. 이 때문에 메서드를 재정 GetEncoding(Int32, EncoderFallback, DecoderFallback) 의하도록 선택하는 경우 가 지원하는 인코딩의 코드 페이지 식별자가 아닌 경우 codepage 재정의가 반환 null 되어야 합니다. 예외를 throw해서는 안 됩니다.

호출자 참고

이 메서드는 GetEncoding(String, EncoderFallback, DecoderFallback) 메서드. 사용자 코드에서 직접 호출해서는 안 됩니다.

추가 정보

• GetEncoding(String, EncoderFallback, DecoderFallback)