EncodingProvider.GetEncoding 메서드

정의

인코딩을 반환합니다.

오버로드

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);
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

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

설명

상속자에 대한 참고 사항

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

인수 값 codepage 이 0인 경우 기본 코드 페이지를 반환하도록 선택할 수도 있습니다.

발신자에 대한 참고 사항

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

구현자 참고

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

호출자 참고

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

추가 정보

적용 대상

GetEncoding(String)

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

public:
 abstract System::Text::Encoding ^ GetEncoding(System::String ^ name);
public abstract System.Text.Encoding GetEncoding (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

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

설명

상속자에 대한 참고 사항

하위 클래스에서 지원하는 인코딩 또는 인코딩을 반환하도록 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(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);
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

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

설명

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

상속자 참고

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

호출자 참고

이 메서드는 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);
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

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

설명

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

상속자 참고

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

호출자 참고

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

추가 정보

적용 대상