EncodingProvider.GetEncoding 메서드

정의

네임스페이스:

System.Text

어셈블리:

mscorlib.dll

인코딩을 반환합니다.

오버로드

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

GetEncoding(Int32)

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

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

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

설명

호출자에 대한 참고 사항

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

구현자 참고

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

호출자 참고

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

추가 정보

• GetEncoding(Int32)

GetEncoding(String)

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

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

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

설명

상속자에 대한 참고 사항

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

호출자에 대한 참고 사항

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

구현자 참고

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

호출자 참고

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

추가 정보

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

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

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

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

설명

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

• 예외 대체. 인수가 encoderFallback 인스턴스 EncoderExceptionFallback이거나 decoderExceptionFallback 인수가 인스턴스 DecoderExceptionFallback인 경우 문자를 인코딩할 수 없는 경우 인코딩 메서드에서 예외를 throw하고 바이트 시퀀스를 디코딩할 수 없는 경우 디코딩 메서드에서 예외를 throw합니다.

• 대체 대체. 인수가 encoderFallback 인스턴스 EncoderReplacementFallback이거나 decoderExceptionFallback 인수가 인스턴스 DecoderReplacementFallback인 경우 인코딩 및 디코딩 메서드는 인코딩할 수 없는 문자로 대체 문자열을 대체하고 바이트 시퀀스를 디코딩할 수 없습니다. 매개 변수가 없는 생성자를 호출하여 대체 대체 개체를 인스턴스화한 경우 대체 문자는 "?"입니다. 또는 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)

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

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

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

설명

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

• 예외 대체. 인수가 encoderFallback 인스턴스 EncoderExceptionFallback이거나 decoderExceptionFallback 인수가 인스턴스 DecoderExceptionFallback인 경우 문자를 인코딩할 수 없는 경우 인코딩 메서드에서 예외를 throw하고 바이트 시퀀스를 디코딩할 수 없는 경우 디코딩 메서드에서 예외를 throw합니다.

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

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

호출자 참고

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

추가 정보

• GetEncoding(String, EncoderFallback, DecoderFallback)