UnicodeEncoding コンストラクタ ()
UnicodeEncoding クラスの新しいインスタンスを初期化します。
名前空間: System.Text
アセンブリ: mscorlib (mscorlib.dll 内)
構文
'宣言
Public Sub New
'使用
Dim instance As New UnicodeEncoding
public UnicodeEncoding ()
public:
UnicodeEncoding ()
public UnicodeEncoding ()
public function UnicodeEncoding ()
適用できません。
解説
このコンストラクタは、リトル エンディアン バイト順を使用し、Unicode バイト順マークを付加し、無効なエンコーディングを検出したときに例外をスローしないインスタンスを作成します。
.gif) 注意 : |
|---|
セキュリティ上の理由から、throwOnInvalidBytes パラメータを受け取るコンストラクタを使用して、このパラメータを true に設定することにより、エラー検出を有効にすることをお勧めします。 |
エンコーダでは、最上位バイトが先頭に配置されるビッグ エンディアン バイト順、または最下位バイトが先頭に配置されるリトル エンディアン バイト順が使用されます。たとえば、Latin の大文字 A (コード ポイント U+0041) は次のように 16 進数でシリアル化されます。
ビッグ エンディアン バイト順 : 00 41
リトル エンディアン バイト順 : 41 00
UnicodeEncoding は、オプションでプリアンブルを提供します。プリアンブルは、エンコーディング プロセスで得られたバイト シーケンスの先頭に付加できるバイトの配列です。プリアンブルにバイト順マーク (コード ポイント U+FEFF) が含まれる場合、デコーダはバイト順および変換形式 (UTF) を判断できます。Unicode バイト順マークは、次のように 16 進数でシリアル化されます。
ビッグ エンディアン バイト順 : FE FF
リトル エンディアン バイト順 : FF FE
通常、ネイティブなバイト順で Unicode 文字を格納した方が効率的です。たとえば、Intel のコンピュータなど、リトル エンディアンのプラットフォームでは、リトル エンディアンのバイト順を使用した方が効率的です。
バイト順とバイト順マークの詳細については、www.unicode.org の「Unicode Standard」を参照してください。
使用例
次のコード例は、新しい UnicodeEncoding インスタンスを作成してエンコード名を表示する方法を示しています。
Imports System
Imports System.Text
Class UnicodeEncodingExample
Public Shared Sub Main()
Dim uni As New UnicodeEncoding()
Dim encodingName As String = uni.EncodingName
Console.WriteLine("Encoding name: " & encodingName)
End Sub 'Main
End Class 'UnicodeEncodingExample
using System;
using System.Text;
class UnicodeEncodingExample {
public static void Main() {
UnicodeEncoding unicode = new UnicodeEncoding();
String encodingName = unicode.EncodingName;
Console.WriteLine("Encoding name: " + encodingName);
}
}
using namespace System;
using namespace System::Text;
int main()
{
UnicodeEncoding^ unicode = gcnew UnicodeEncoding;
String^ encodingName = unicode->EncodingName;
Console::WriteLine( "Encoding name: {0}", encodingName );
}
import System.*;
import System.Text.*;
class UnicodeEncodingExample
{
public static void main(String[] args)
{
UnicodeEncoding unicode = new UnicodeEncoding();
String encodingName = unicode.get_EncodingName();
Console.WriteLine(("Encoding name: " + encodingName));
} //main
} //UnicodeEncodingExample
プラットフォーム
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0
.NET Compact Framework
サポート対象 : 2.0,1.0
XNA Framework
サポート対象 : 1.0