Encoding.GetEncoding メソッド (Int32)

指定したコード ページ値に対応する Encoding を返します。

Overloads Public Shared Function GetEncoding( _
   ByVal codepage As Integer _) As Encoding
[C#]
public static Encoding GetEncoding(intcodepage);
[C++]
public: static Encoding* GetEncoding(intcodepage);
[JScript]
public static function GetEncoding(
   codepage : int) : Encoding;

パラメータ

• codepage
  適切なエンコーディングに対応するコード ページ値。

戻り値

要求されたエンコーディング。

例外

解説

メモ   サポートされていないコード ページが使用されると、 ArgumentException や NotSupportedException が発生することがあります。したがって開発者は、「例外」に示されているすべての例外がキャッチされるようにする必要があります。

GetEncoding メソッドは、多くのコード ページをサポートしている、基になるプラットフォームに依存します。ただし、次の場合には、システム サポートが提供されます。既定のエンコーディングにはコード ページ 0 を指定します。つまり、このメソッドを実行しているコンピュータの地域設定で指定されているエンコーディングです。リトル エンディアン Unicode (UTF-16LE) には 1200、ビッグ エンディアン Unicode (UTF-16BE) には 1201、Windows オペレーティング システム (Windows-1252) には 1252、UTF-7 には 65000、UTF-8 には 65001、ASCII には 20127、GB18030 (Chinese Simplified) には 54936 を指定します。

たとえば、Windows-1252 コード ページ (コード ページ値 1252) のエンコーディングは、次に示す C# コードで作成できます。

Encoding enc = Encoding.GetEncoding(1252);

プラットフォームによっては、特定のコード ページがサポートされていない場合があります。たとえば、日本の shift-jis コード ページ (コード ページ 932) は、Windows 98 の米国版ではサポートされていない場合があります。この場合、次に示す C# コードが実行されると、 GetEncoding メソッドは NotSupportedException をスローします。

Encoding enc = Encoding.GetEncoding(932);

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

Encoding クラス | Encoding メンバ | System.Text 名前空間 | Encoding.GetEncoding オーバーロードの一覧