Encoding.RegisterProvider(EncodingProvider) Encoding.RegisterProvider(EncodingProvider) Encoding.RegisterProvider(EncodingProvider) Encoding.RegisterProvider(EncodingProvider) Method

정의

인코딩 공급자를 등록합니다.Registers an encoding provider.

public:
 static void RegisterProvider(System::Text::EncodingProvider ^ provider);
[System.Security.SecurityCritical]
public static void RegisterProvider (System.Text.EncodingProvider provider);
static member RegisterProvider : System.Text.EncodingProvider -> unit
Public Shared Sub RegisterProvider (provider As EncodingProvider)

매개 변수

provider
EncodingProvider EncodingProvider EncodingProvider EncodingProvider

추가 문자 인코딩에 대한 액세스를 제공하는 EncodingProvider의 하위 클래스입니다.A subclass of EncodingProvider that provides access to additional character encodings.

예외

설명

합니다 RegisterProvider 메서드를 사용 하면에서 파생 된 클래스를 등록할 수 있습니다 EncodingProvider 는 그렇지 않은 경우 지원 하지 않는 플랫폼에서 사용할 수 있는 인코딩 문자는 합니다.The RegisterProvider method allows you to register a class derived from EncodingProvider that makes character encodings available on a platform that does not otherwise support them. 지원 되는 인코딩은 인코딩 공급자 등록 되 면 하나를 호출 하 여 검색할 수 있습니다 Encoding.GetEncoding 오버 로드 합니다.Once the encoding provider is registered, the encodings that it supports can be retrieved by calling any Encoding.GetEncoding overload. 여러 인코딩 공급자에 있는 경우는 Encoding.GetEncoding 메서드 가장 최근에 등록 된 것으로 시작 하는 각 공급자에서 지정 된 인코딩을 검색 하려고 시도 합니다.If there are multiple encoding providers, the Encoding.GetEncoding method attempts to retrieve a specified encoding from each provider starting with the one most recently registered.

인코딩 공급자를 사용 하 여 등록 합니다 RegisterProvider 메서드는 또한의 동작을 수정 합니다 Encoding.GetEncoding(Int32)EncodingProvider.GetEncoding (Int32, EncoderFallback, DecoderFallback ) 메서드는 인수를 전달 하는 경우 0:Registering an encoding provider by using the RegisterProvider method also modifies the behavior of the Encoding.GetEncoding(Int32) and EncodingProvider.GetEncoding(Int32, EncoderFallback, DecoderFallback) methods when passed an argument of 0:

  • 등록 된 공급자가는 CodePagesEncodingProvider, 메서드는 Windows 운영 체제를 실행 하는 경우 시스템 활성 코드 페이지와 일치 하는 인코딩을 반환 합니다.If the registered provider is the CodePagesEncodingProvider, the method returns the encoding that matches the system active code page when running on the Windows operating system.

  • 사용자 지정 인코딩 공급자를 반환할 때 인코딩을 선택할 수 있습니다 이러한 GetEncoding 메서드 오버 로드의 인수로 전달 됩니다 0합니다.A custom encoding provider can choose which encoding to return when either of these GetEncoding method overloads is passed an argument of 0. 공급자 함으로써 인코딩을 반환 하지 하도록 선택할 수도 있습니다는 EncodingProvider.GetEncoding 메서드가 반환 null합니다.The provider can also choose to not return an encoding by having the EncodingProvider.GetEncoding method return null.

.NET Framework 4.6 부터는.NET Framework에 하나의 인코딩 공급자 CodePagesEncodingProvider, 전체.NET Framework에는 유니버설 Windows 플랫폼에서 사용할 수 없는 인코딩을 사용할 수 있도록 합니다.Starting with the .NET Framework 4.6, the .NET Framework includes one encoding provider, CodePagesEncodingProvider, that makes the encodings available that are present in the full .NET Framework but are not available in the Universal Windows Platform. 유니버설 Windows 플랫폼을 기본적으로 유니코드, ASCII 인코딩과 코드 페이지 28591만 지원합니다.By default, the Universal Windows Platform only supports the Unicode encodings, ASCII, and code page 28591.

동일한 인코딩 공급자에 대 한 여러 호출에 사용 되 면는 RegisterProvider 공급자를 등록 하는 메서드를 첫 번째 메서드 호출 합니다.If the same encoding provider is used in multiple calls to the RegisterProvider method, only the first method call registers the provider. 후속 호출은 무시 됩니다.Subsequent calls are ignored.

경우는 RegisterProvider 메서드 같은 인코딩을 처리 하는 여러 공급자를 등록 하는, 마지막으로 등록 된 공급자가 모든 인코딩 및 디코딩 작업에 사용 합니다.If the RegisterProvider method is called to register multiple providers that handle the same encoding, the last registered provider is the used for all encoding and decoding operations. 이전에 등록 된 모든 공급자는 무시 됩니다.Any previously registered providers are ignored.

적용 대상

추가 정보