UnicodeEncoding クラスとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

UnicodeEncoding クラス

Unicode 文字の UTF-16 エンコーディングを表します。

名前空間: System.Text
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class UnicodeEncoding
    Inherits Encoding

Visual Basic (使用法)

Dim instance As UnicodeEncoding

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class UnicodeEncoding : Encoding

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class UnicodeEncoding : public
 Encoding

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class UnicodeEncoding extends Encoding

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class UnicodeEncoding extends
 Encoding

解説

エンコーディングは、Unicode 文字のセットをバイトシーケンスに変換するプロセスです。デコードはその逆になります。エンコードされたバイトシーケンスを Unicode 文字のセットに変換するプロセスです。

Unicode Standard では、サポートされるすべてのスクリプトについて、各文字にコードポイント (数値) を割り当てています。コードポイントのエンコードには UTF (Unicode Transformation Format) が使用されます。Unicode Standard バージョン 3.2 では、次の UTF が使用されています。

UTF-8。各コードポイントが、1 バイトから 4 バイトのシーケンスとして表現されます。
UTF-16。各コードポイントが、1 つまたは 2 つの 16 ビット整数のシーケンスとして表現されます。
UTF-32。各コードポイントが 32 ビット整数として表現されます。

GetByteCount メソッドは、Unicode 文字のセットをエンコードした結果得られるバイト数を確認します。実際のエンコードは、GetBytes メソッドによって実行されます。

同様に、GetCharCount メソッドは、バイトシーケンスをデコードした結果得られる文字数を確認します。実際のデコードは、GetChars メソッドと GetString メソッドによって実行されます。

エンコーダでは、最上位バイトが先頭に配置されるビッグエンディアンバイト順、または最下位バイトが先頭に配置されるリトルエンディアンバイト順が使用されます。たとえば、Latin の大文字 A (コードポイント U+0041) は次のように 16 進数でシリアル化されます。

ビッグエンディアンバイト順 : 00 41
リトルエンディアンバイト順 : 41 00

UnicodeEncoding は、オプションでプリアンブルを提供します。プリアンブルは、エンコーディングプロセスで得られたバイトシーケンスの先頭に付加できるバイトの配列です。プリアンブルにバイト順マーク (コードポイント U+FEFF) が含まれる場合、デコーダはバイト順および変換形式 (UTF) を判断できます。Unicode バイト順マークは、次のように 16 進数でシリアル化されます。

ビッグエンディアンバイト順 : FE FF
リトルエンディアンバイト順 : FF FE

通常、ネイティブなバイト順で Unicode 文字を格納した方が効率的です。たとえば、Intel のコンピュータなど、リトルエンディアンのプラットフォームでは、リトルエンディアンのバイト順を使用した方が効率的です。

GetPreamble メソッドは、バイト順マークを格納するバイト配列を返します。このバイト配列がエンコード済みストリームの前に付加されていると、デコーダによる使用エンコーディング形式の識別に役立ちます。

Unicode エンコーディング、バイト順、およびバイト順マークの詳細については、www.unicode.org の「Unicode Standard」を参照してください。

メモ
エラー検出を有効にしてクラスインスタンスの安全性を向上させるには、throwOnInvalidBytes パラメータを受け取る UnicodeEncoding コンストラクタを使用し、このパラメータを true に設定します。エラー検出を有効にすると、メソッドは、無効な文字シーケンスやバイトシーケンスを検出したときに、ArgumentException をスローします。エラー検出を無効にすると、例外はスローされず、無効なシーケンスは全般に無視されます。

メモ

エラー検出を有効にしてクラスインスタンスの安全性を向上させるには、throwOnInvalidBytes パラメータを受け取る UnicodeEncoding コンストラクタを使用し、このパラメータを true に設定します。エラー検出を有効にすると、メソッドは、無効な文字シーケンスやバイトシーケンスを検出したときに、ArgumentException をスローします。エラー検出を無効にすると、例外はスローされず、無効なシーケンスは全般に無視されます。

UnicodeEncoding は、Windows コードページ 1200 (リトルエンディアンバイト順) と 1201 (ビッグエンディアンバイト順) に対応しています。

使用例

次のコード例は、UnicodeEncoding を使用して、Unicode 文字列をバイト配列にエンコードする方法を示しています。データが損失しないことを示すため、バイト配列は文字列にデコードされます。

Visual Basic

Imports System
Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        ' The encoding.
        Dim uni As New UnicodeEncoding()
        
        ' Create a string that contains Unicode characters.
        Dim unicodeString As String
 = _
            "This Unicode string contains two characters "
 & _
            "with codes outside the traditional ASCII code range,
 " & _
            "Pi (" & ChrW(928) & ")
 and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        
        ' Encode the string.
        Dim encodedBytes As Byte()
 = uni.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Dim b As Byte
        For Each b In  encodedBytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
        
        ' Decode bytes back to string.
        ' Notice Pi and Sigma characters are still present.
        Dim decodedString As String
 = uni.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main()
 {
        // The encoding.
        UnicodeEncoding unicode = new UnicodeEncoding();
        
        // Create a string that contains Unicode characters.
        String unicodeString =
            "This Unicode string contains two characters
 " +
            "with codes outside the traditional ASCII code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = unicode.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
        
        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = unicode.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}

C++

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   
   // The encoding.
   UnicodeEncoding^ unicode = gcnew UnicodeEncoding;
   
   // Create a String* that contains Unicode characters.
   String^ unicodeString = L"This Unicode string contains
 two characters with codes outside the traditional ASCII code range, Pi (\u03a0)
 and Sigma (\u03a3).";
   Console::WriteLine( "Original string:" );
   Console::WriteLine( unicodeString );
   
   // Encode the String*.
   array<Byte>^encodedBytes = unicode->GetBytes( unicodeString );
   Console::WriteLine();
   Console::WriteLine( "Encoded bytes:" );
   IEnumerator^ myEnum = encodedBytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
   
   // Decode bytes back to String*.
   // Notice Pi and Sigma characters are still present.
   String^ decodedString = unicode->GetString( encodedBytes );
   Console::WriteLine();
   Console::WriteLine( "Decoded bytes:" );
   Console::WriteLine( decodedString );
}

import System.*;
import System.Text.*;

class UnicodeEncodingExample
{
    public static void main(String[]
 args)
    {
        // The encoding.
        UnicodeEncoding unicode = new UnicodeEncoding();

        // Create a string that contains Unicode characters.
        String unicodeString = "This Unicode string contains
 two characters " 
            + "with codes outside the traditional ASCII code range, " 
            + "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        ubyte encodedBytes[] = unicode.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        for(int iCtr = 0; iCtr < encodedBytes.length;
 iCtr++) {
            ubyte b = encodedBytes[iCtr];
            Console.Write("[{0}]", String.valueOf(b));
        }
        Console.WriteLine();

        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = unicode.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    } //main
} //UnicodeEncodingExample

継承階層

System.Object
System.Text.Encoding
System.Text.UnicodeEncoding

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
UnicodeEncoding メンバ
System.Text 名前空間
Encoding クラス
Encoder クラス
Decoder クラス
UTF32Encoding
UTF8Encoding
UTF7Encoding
ASCIIEncoding クラス
System.Globalization.UnicodeCategory
System.Globalization.CharUnicodeInfo

このページでは「.NET Framework クラスライブラリリファレンス」からUnicodeEncoding クラスを検索した結果を表示しています。
Weblioに収録されているすべての辞書からUnicodeEncoding クラスを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からUnicodeEncoding クラスを検索

>> 「UnicodeEncoding クラス」を含む用語の索引
UnicodeEncoding クラスのページへのリンク

UnicodeEncoding クラスとは？わかりやすく解説

UnicodeEncoding クラス

「UnicodeEncoding クラス」の関連用語


	© 2024 Microsoft.All rights reserved.

UnicodeEncoding クラスとは？ わかりやすく解説

UnicodeEncoding クラス

急上昇のことば

「UnicodeEncoding クラス」の関連用語

UnicodeEncoding クラスとは？わかりやすく解説