CodePagesEncodingProvider.GetEncoding メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| GetEncoding(Int32) |
指定したコード ページ識別子に関連付けられているエンコードを返します。 |
| GetEncoding(String) |
指定したコード ページ名に関連付けられているエンコードを返します。 |
注釈
.NET Framework では、多数の文字エンコードとコード ページがサポートされています。 .NET Framework で使用できる Encoding.GetEncodings メソッドを呼び出すと、エンコードの完全な一覧を取得できます。 一方、.NET Core では、既定では次のエンコードのみがサポートされています。
Encoding.ASCII プロパティによって返される ASCII (コード ページ 20127)。
ISO-8859-1 (コード ページ 28591)。
utf-7 (コード ページ 65000)、 Encoding.UTF7 プロパティによって返されます。
UTF-8 (コード ページ 65001)。 Encoding.UTF8 プロパティによって返されます。
UTF-16 および UTF-16LE (コード ページ 1200)。 Encoding.Unicode プロパティによって返されます。
UTF-16BE (コード ページ 1201)。 UnicodeEncoding.UnicodeEncodingのUnicodeEncoding.UnicodeEncoding値を持つ
bigEndianまたはtrueコンストラクターを呼び出すことによってインスタンス化されます。UTF-32 および UTF-32LE (コード ページ 12000)。これは、 Encoding.UTF32 プロパティによって返されます。
UTF-32BE (コード ページ 12001) は、UTF32Encoding パラメーターを持つ
bigEndianコンストラクターを呼び出し、メソッド呼び出しでtrue値を指定することによってインスタンス化されます。
.NET Framework に存在し、.NET Core には存在しないエンコードを取得するには、次の操作を行います。
System.Text.Encoding.CodePages.dll アセンブリへの参照をプロジェクトに追加します。
静的EncodingProvider プロパティからCodePagesEncodingProvider.Instance オブジェクトを取得します。
EncodingProvider オブジェクトを Encoding.RegisterProvider メソッドに渡して、EncodingProvider オブジェクトによって提供されるエンコーディングを共通言語ランタイムで使用できるようにします。
Encoding.GetEncoding オーバーロードを呼び出してエンコードを取得します。 Encoding.GetEncoding メソッドは、対応するEncodingProvider.GetEncoding メソッドを呼び出して、要求されたエンコードを指定できるかどうかを判断します。
GetEncoding(Int32)
指定したコード ページ識別子に関連付けられているエンコードを返します。
public:
override System::Text::Encoding ^ GetEncoding(int codepage);public override System.Text.Encoding? GetEncoding(int codepage);public override System.Text.Encoding GetEncoding(int codepage);override this.GetEncoding : int -> System.Text.EncodingPublic Overrides Function GetEncoding (codepage As Integer) As Encodingパラメーター
- codepage
- Int32
エンコード プロバイダーがサポートする可能性がある優先エンコードのコード ページ識別子。
返品
指定したコード ページ識別子に関連付けられたエンコード。または、プロバイダーが要求されたコード ページ エンコードをサポートしていない場合に null 。
注釈
このメソッドは、.NET Framework で使用できますが、.NET Core 以降のバージョンではネイティブにサポートされていないコード ページ エンコードにアクセスできます。
codepageが0場合、このメソッドには、GetEncoding(Int32)によって返される既定のエンコードに影響する特別な動作があります。
- Windows の場合: .NET Framework と同じ動作を提供して、システムのアクティブなコード ページに一致するエンコードを返します。
-
Windows 以外のプラットフォームの場合:
nullを返し、 GetEncoding(Int32) が既定の UTF-8 動作にフォールバックできるようにします。
サポートされているすべてのコード ページ識別子について、このメソッドは、コード ページ エンコード プロバイダーから使用可能な場合は対応するエンコードを返し、コード ページがサポートされていない場合は null します。
適用対象
GetEncoding(String)
指定したコード ページ名に関連付けられているエンコードを返します。
public:
override System::Text::Encoding ^ GetEncoding(System::String ^ name);public override System.Text.Encoding? GetEncoding(string name);public override System.Text.Encoding GetEncoding(string name);override this.GetEncoding : string -> System.Text.EncodingPublic Overrides Function GetEncoding (name As String) As Encodingパラメーター
- name
- String
エンコード プロバイダーがサポートする可能性がある優先エンコードのコード ページ名。
返品
指定したコード ページに関連付けられているエンコード。プロバイダーが要求されたエンコードをサポートしていない場合は null 。
