• 目的の文字コードに合ったEncodingオブジェクトを取得する
  • Encoding.GetEncodingメソッドを使う
  • Encodingクラスの静的プロパティを使う
  • Encodingクラスのコンストラクタを呼び出す

• この記事への評価、コメント

目的の文字コードに合ったEncodingオブジェクトを取得する

例えばテキストファイルを文字列（String型）として読み込む時、そのテキストファイルの文字コードが何であるかによって、適切なエンコーディング（注）を選択する必要があります。そのエンコーディングを表すのが、Encodingオブジェクトです。適切なEncodingオブジェクトを選択してテキストファイルを読み込まないと、文字化けします。

同様に文字列をテキストファイルに書き込む時も、どのような文字コードで書き込むかによって適切なEncodingオブジェクトを選択する必要があります。

ここでは、目的の文字コードに合ったEncodingオブジェクトを取得する方法について説明します。

なおテキストファイルを読み込む方法は「文字コードを指定してテキストファイルを読み込む」で、テキストファイルに書き込む方法は「文字コードを指定してテキストファイルに書き込む」で説明していますので、ここでは説明しません。

• 関連：
• 文字コードを判別する

Encoding.GetEncodingメソッドを使う

Encoding.GetEncodingメソッドを使うことで、指定したエンコーディングのEncodingオブジェクトを取得することができます。この時、エンコーディングのコードページ名かコードページIDを指定する必要があります。コードページ名はString型で、コードページIDはInt32型で指定します。

サポートしているエンコーディングとそのコードページIDおよびコードページ名の一覧がMSDNの「Encoding クラス」にあります。また、サポートしているエンコーディングをすべて取得する方法とその結果の例を、「サポートしているEncodingをすべて取得する」で紹介しています。

日本語に関係したエンコーディングのコードページIDとコードページ名を以下に示します。

シフトJISのテキストファイルを作成する例を以下に示します。

'シフトJISのEncodingオブジェクトを作成する
Dim enc As System.Text.Encoding = System.Text.Encoding.GetEncoding(932)
'または、次のようにすることもできる
'Dim enc As System.Text.Encoding = System.Text.Encoding.GetEncoding("shift_jis")

'シフトJISでテキストファイルを作成する
Dim sw As New System.IO.StreamWriter("C:\test\1.txt", False, enc)
sw.Write("こんにちは。")
sw.Close()

//シフトJISのEncodingオブジェクトを作成する
System.Text.Encoding enc = System.Text.Encoding.GetEncoding(932);
//または、次のようにすることもできる
//System.Text.Encoding enc =System.Text.Encoding.GetEncoding("shift_jis");

//シフトJISでテキストファイルを作成する
System.IO.StreamWriter sw = new System.IO.StreamWriter(
    @"C:\test\1.txt", false, enc);
sw.Write("こんにちは。");
sw.Close();

Encodingクラスの静的プロパティを使う

もっとお手軽な方法として、Encodingクラスの静的プロパティを使用する方法があります。Encodingクラスの静的プロパティには、よく使われるEncodingオブジェクトがあらかじめ幾つか用意されています。

このようなプロパティには、以下のようなものがあります。

UTF-8（BOM付き）のテキストファイルを作成する例を以下に示します。

'UTF-8でテキストファイルを作成する
Dim sw As New System.IO.StreamWriter( _
    "C:\test\1.txt", False, System.Text.Encoding.UTF8)
sw.Write("こんにちは。")
sw.Close()

//UTF-8でテキストファイルを作成する
System.IO.StreamWriter sw = new System.IO.StreamWriter(
    @"C:\test\1.txt", false, System.Text.Encoding.UTF8);
sw.Write("こんにちは。");
sw.Close();

Encodingクラスのコンストラクタを呼び出す

Encodingクラスは抽象クラスですが、UnicodeとASCIIに関するエンコーディングについては、Encodingクラスから派生した専用のクラスが公開されています。これらのコンストラクタを直接呼び出すことで、Encodingオブジェクトを作成することができます。

このようなクラスには、以下のようなものがあります（MSDNからの抜粋です）。

この方法には、大きなメリットがあります。それは、Unicode系のエンコーディングでStreamに書き出す時、BOM（バイトオーダーマーク、バイト順マーク、byte order mark）を付けないようにできることです（UTF7Encoding以外）。今まで紹介してきた方法では、必ずBOMが付きます。

また、この方法では、無効な文字やバイトシーケンスがあったときに例外をスローさせるようにすることもできます（ASCIIEncoding、UTF7Encoding以外）。

具体的には、UTF8Encodingでは1番目、UnicodeEncodingとUTF32Encodingでは2番目のパラメータがTrueの時BOMが付加し、Falseの時は付加しません。省略するとFalseになり、付加しません。

UTF8Encodingでは2番目、UnicodeEncodingとUTF32Encodingでは3番目のパラメータがTrueの時、無効な文字やバイトシーケンスがあると例外ArgumentExceptionをスローします（UnicodeEncodingとUTF32Encodingは.NET Framework 2.0以降）。省略するとFalseになり、エラーは出ません。

UnicodeEncodingとUTF32Encodingでは、1番目のパラメータがTrueの時ビッグエンディアンバイト順を使用し、Falseの時はリトルエンディアンバイト順を使用します。省略するとFalseになります。

この方法で様々なEncodingオブジェクトを作成する例を以下に示します。

'BOMを付けない。また、無効なエンコーディングで例外をスローさせる。
Dim utf8Enc As System.Text.Encoding = _
    New System.Text.UTF8Encoding(False, True)
Console.WriteLine("{0},{1},{2}", _
    utf8Enc.EncodingName, utf8Enc.CodePage, utf8Enc.WebName)
'Unicode (UTF-8),65001,utf-8

'リトルエンディアン。BOMを付けない。例外をスローさせる。
Dim utf16be As System.Text.Encoding = _
    New System.Text.UnicodeEncoding(False, False, True)
Console.WriteLine("{0},{1},{2}", _
    utf16be.EncodingName, utf16be.CodePage, utf16be.WebName)
'Unicode,1200,utf-16

'ビッグエンディアン。BOMを付けない。例外をスローさせる。
Dim utf32le As System.Text.Encoding = _
    New System.Text.UTF32Encoding(True, False, True)
Console.WriteLine("{0},{1},{2}", _
    utf32le.EncodingName, utf32le.CodePage, utf32le.WebName)
'Unicode (UTF-32 ビッグ エンディアン),12001,utf-32BE

//BOMを付けない。また、無効なエンコーディングで例外をスローさせる。
System.Text.Encoding utf8Enc =
    new System.Text.UTF8Encoding(false, true);
Console.WriteLine("{0},{1},{2}",
    utf8Enc.EncodingName, utf8Enc.CodePage, utf8Enc.WebName);
//Unicode (UTF-8),65001,utf-8

//リトルエンディアン。BOMを付けない。例外をスローさせる。
System.Text.Encoding utf16be =
    new System.Text.UnicodeEncoding(false, false, true);
Console.WriteLine("{0},{1},{2}",
    utf16be.EncodingName, utf16be.CodePage, utf16be.WebName);
//Unicode,1200,utf-16

//ビッグエンディアン。BOMを付けない。例外をスローさせる。
System.Text.Encoding utf32le =
    new System.Text.UTF32Encoding(true, false, true);
Console.WriteLine("{0},{1},{2}",
    utf32le.EncodingName, utf32le.CodePage, utf32le.WebName);
//Unicode (UTF-32 ビッグ エンディアン),12001,utf-32BE

• 関連：
• BOM無しのUTF-8でテキストファイルに書き込む