UnicodeEncoding コンストラクタとは？わかりやすく解説

辞書 類語・対義語辞典 英和・和英辞典 日中中日辞典 日韓韓日辞典 古語辞典

その他の辞書▼
- フランス語辞典
- インドネシア語辞典
- タイ語辞典
- ベトナム語辞典

Weblio 辞書ヘルプ

556の専門辞書や国語辞典百科事典から一度に検索!

無料の翻訳ならWeblio翻訳！

初めての方へ参加元一覧

Weblio 辞書 > コンピュータ > .NET Framework クラスライブラリリファレンス > UnicodeEncoding コンストラクタの意味・解説

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

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

UnicodeEncoding コンストラクタ (Boolean, Boolean)

UnicodeEncoding クラスの新しいインスタンスを初期化します。パラメータでは、ビッグエンディアンバイト順を使用するかどうか、および Unicode バイト順マークを付加するかどうかを指定します。

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

Visual Basic (宣言)

Public Sub New ( _
    bigEndian As Boolean, _
    byteOrderMark As Boolean _
)

Visual Basic (使用法)

Dim bigEndian As Boolean
Dim byteOrderMark As Boolean

Dim instance As New UnicodeEncoding(bigEndian,
 byteOrderMark)

public UnicodeEncoding (
    bool bigEndian,
    bool byteOrderMark
)

public:
UnicodeEncoding (
    bool bigEndian, 
    bool byteOrderMark
)

public UnicodeEncoding (
    boolean bigEndian, 
    boolean byteOrderMark
)

public function UnicodeEncoding (
    bigEndian : boolean, 
    byteOrderMark : boolean
)

パラメータ

bigEndian: 最上位バイトが先頭に配置されるビッグエンディアンバイト順を使用する場合は true。最下位バイトが先頭に配置されるリトルエンディアンバイト順を使用する場合は false。

byteOrderMark: Unicode バイト順マークを付加するよう指定する場合は true。それ以外の場合は false。

このコンストラクタは、無効なエンコーディングを検出したときに例外をスローしないインスタンスを作成します。

注意
セキュリティ上の理由から、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」を参照してください。

使用例

次のコード例は、リトルエンディアンまたはビッグエンディアンのどちらのバイト順をサポートするか、および Unicode バイト順マークをサポートするかどうかを指定して、新しい UnicodeEncoding インスタンスを作成する方法を示しています。UnicodeEncoding インスタンスの動作は、bigEndian パラメータと byteOrderMark パラメータの値によって異なります。

Imports System
Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()

        ' Create a UnicodeEncoding without parameters.
        Dim unicodeDefault As New
 UnicodeEncoding()

        ' Create a UnicodeEncoding to support little-endian byte ordering
        ' and include the Unicode byte order mark.        
        Dim unicodeLittleEndianBOM As New
 UnicodeEncoding(False, True)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without
 parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeLittleEndianBOM))
        
        ' Create a UnicodeEncoding to support little-endian byte ordering
        ' and not include the Unicode byte order mark.
        Dim unicodeLittleEndianNoBOM As New
 UnicodeEncoding(False, False)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without
 parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeLittleEndianNoBOM))
        
        ' Create a UnicodeEncoding to support big-endian byte ordering
        ' and include the Unicode byte order mark.
        Dim unicodeBigEndianBOM As New
 UnicodeEncoding(True, True)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without
 parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeBigEndianBOM))
        
        ' Create a UnicodeEncoding to support big-endian byte ordering
        ' and not include the Unicode byte order mark.
        Dim unicodeBigEndianNoBOM As New
 UnicodeEncoding(True, False)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without
 parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeBigEndianNoBOM))
    End Sub
    
    
    Public Shared Sub DescribeEquivalence(isEquivalent
 As Boolean)
        Dim phrase as String
        If isEquivalent Then
            phrase = "An"
        Else
            phrase = "Not an"
        End If
        Console.WriteLine("{0} equivalent encoding.",
 phrase)
    End Sub
End Class

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main()
 {

        // Create a UnicodeEncoding without parameters.
        UnicodeEncoding unicode = new UnicodeEncoding();

        // Create a UnicodeEncoding to support little-endian byte ordering
        // and include the Unicode byte order mark.
        UnicodeEncoding unicodeLittleEndianBOM = 
            new UnicodeEncoding(false, true);
        // Compare this UnicodeEncoding to the UnicodeEncoding without
 parameters.
        DescribeEquivalence(unicode.Equals(unicodeLittleEndianBOM));

        // Create a UnicodeEncoding to support little-endian byte ordering
        // and not include the Unicode byte order mark.
        UnicodeEncoding unicodeLittleEndianNoBOM =
            new UnicodeEncoding(false, false);
        // Compare this UnicodeEncoding to the UnicodeEncoding without
 parameters.
        DescribeEquivalence(unicode.Equals(unicodeLittleEndianNoBOM));

        // Create a UnicodeEncoding to support big-endian byte ordering
        // and include the Unicode byte order mark.
        UnicodeEncoding unicodeBigEndianBOM =
            new UnicodeEncoding(true, true);
        // Compare this UnicodeEncoding to the UnicodeEncoding without
 parameters.
        DescribeEquivalence(unicode.Equals(unicodeBigEndianBOM));

        // Create a UnicodeEncoding to support big-endian byte ordering
        // and not include the Unicode byte order mark.
        UnicodeEncoding unicodeBigEndianNoBOM =
            new UnicodeEncoding(true, false);
        // Compare this UnicodeEncoding to the UnicodeEncoding without
 parameters.
        DescribeEquivalence(unicode.Equals(unicodeBigEndianNoBOM));
    }

    public static void DescribeEquivalence(Boolean
 isEquivalent) {
        Console.WriteLine(
            "{0} equivalent encoding.", (isEquivalent ? "An"
 : "Not an")
        );
    }
}

using namespace System;
using namespace System::Text;
void DescribeEquivalence( Boolean isEquivalent )
{
   Console::WriteLine( " {0} equivalent encoding.", (isEquivalent ? (String^)"An"
 : "Not an") );
}

int main()
{
   
   // Create a UnicodeEncoding without parameters.
   UnicodeEncoding^ unicode = gcnew UnicodeEncoding;
   
   // Create a UnicodeEncoding to support little-endian Byte ordering
   // and include the Unicode Byte order mark.
   UnicodeEncoding^ unicodeLittleEndianBOM = gcnew UnicodeEncoding( false,true
 );
   
   // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
   DescribeEquivalence( unicode->Equals( unicodeLittleEndianBOM ) );
   
   // Create a UnicodeEncoding to support little-endian Byte ordering
   // and not include the Unicode Byte order mark.
   UnicodeEncoding^ unicodeLittleEndianNoBOM = gcnew UnicodeEncoding( false,false
 );
   
   // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
   DescribeEquivalence( unicode->Equals( unicodeLittleEndianNoBOM ) );
   
   // Create a UnicodeEncoding to support big-endian Byte ordering
   // and include the Unicode Byte order mark.
   UnicodeEncoding^ unicodeBigEndianBOM = gcnew UnicodeEncoding( true,true
 );
   
   // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
   DescribeEquivalence( unicode->Equals( unicodeBigEndianBOM ) );
   
   // Create a UnicodeEncoding to support big-endian Byte ordering
   // and not include the Unicode Byte order mark.
   UnicodeEncoding^ unicodeBigEndianNoBOM = gcnew UnicodeEncoding( true,false
 );
   
   // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
   DescribeEquivalence( unicode->Equals( unicodeBigEndianNoBOM ) );
}

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

class UnicodeEncodingExample
{
    public static void main(String[]
 args)
    {
        // Create a UnicodeEncoding without parameters.
        UnicodeEncoding unicode = new UnicodeEncoding();

        // Create a UnicodeEncoding to support little-endian byte ordering
        // and include the Unicode byte order mark.
        UnicodeEncoding unicodeLittleEndianBOM = new 
            UnicodeEncoding(false, true);

        // Compare this UnicodeEncoding to the
        // UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeLittleEndianBOM));

        // Create a UnicodeEncoding to support little-endian byte ordering
        // and not include the Unicode byte order mark.
        UnicodeEncoding unicodeLittleEndianNoBOM = new 
            UnicodeEncoding(false, false);

        // Compare this UnicodeEncoding to the UnicodeEncoding 
        // without parameters.
        DescribeEquivalence(unicode.Equals(unicodeLittleEndianNoBOM));

        // Create a UnicodeEncoding to support big-endian byte ordering
        // and include the Unicode byte order mark.
        UnicodeEncoding unicodeBigEndianBOM = new UnicodeEncoding(true,
 true);

        // Compare this UnicodeEncoding to the
        // UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeBigEndianBOM));

        // Create a UnicodeEncoding to support big-endian byte ordering
        // and not include the Unicode byte order mark.
        UnicodeEncoding unicodeBigEndianNoBOM = new 
            UnicodeEncoding(true, false);

        // Compare this UnicodeEncoding to the
        // UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeBigEndianNoBOM));
    } //main

    public static void DescribeEquivalence(boolean
 isEquivalent)
    {
        Console.WriteLine("{0} equivalent encoding.",
            (isEquivalent) ? "An" : "Not an");
    } //DescribeEquivalence
} //UnicodeEncodingExample

プラットフォーム

プラットフォーム

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 クラス
UnicodeEncoding メンバ
System.Text 名前空間
GetPreamble

UnicodeEncoding コンストラクタ (Boolean, Boolean, Boolean)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

UnicodeEncoding クラスの新しいインスタンスを初期化します。パラメータでは、ビッグエンディアンバイト順を使用するかどうか、Unicode バイト順マークを付加するかどうか、および無効なエンコーディングを検出したときに例外をスローするかどうかを指定します。

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

Visual Basic (宣言)

Public Sub New ( _
    bigEndian As Boolean, _
    byteOrderMark As Boolean, _
    throwOnInvalidBytes As Boolean _
)

Visual Basic (使用法)

Dim bigEndian As Boolean
Dim byteOrderMark As Boolean
Dim throwOnInvalidBytes As Boolean

Dim instance As New UnicodeEncoding(bigEndian,
 byteOrderMark, throwOnInvalidBytes)

public UnicodeEncoding (
    bool bigEndian,
    bool byteOrderMark,
    bool throwOnInvalidBytes
)

public:
UnicodeEncoding (
    bool bigEndian, 
    bool byteOrderMark, 
    bool throwOnInvalidBytes
)

public UnicodeEncoding (
    boolean bigEndian, 
    boolean byteOrderMark, 
    boolean throwOnInvalidBytes
)

public function UnicodeEncoding (
    bigEndian : boolean, 
    byteOrderMark : boolean, 
    throwOnInvalidBytes : boolean
)

パラメータ

bigEndian: 最上位バイトが先頭に配置されるビッグエンディアンバイト順を使用する場合は true。最下位バイトが先頭に配置されるリトルエンディアンバイト順を使用する場合は false。

byteOrderMark: Unicode バイト順マークを付加するよう指定する場合は true。それ以外の場合は false。

throwOnInvalidBytes: 無効なエンコーディングが検出された場合に、例外をスローすることを指定する場合は true。それ以外の場合は false。

throwOnInvalidBytes パラメータが true の場合、無効なバイトシーケンスを検出したメソッドは System.ArgumentException をスローします。それ以外の場合は、例外をスローせず、無効なシーケンスを無視します。

注意
セキュリティ上の理由から、このコンストラクタを使用して UnicodeEncoding クラスのインスタンスを作成し、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
Imports Microsoft.VisualBasic

Public Class SamplesUnicodeEncoding   

   Public Shared Sub Main()

      ' Create an instance of UnicodeEncoding using little-endian byte
 order.
      ' This will be used for encoding.
      Dim u16LE As New UnicodeEncoding(False,
 True)

      ' Create two instances of UnicodeEncoding using big-endian byte
 order: one with error detection and one without.
      ' These will be used for decoding.
      Dim u16withED As New
 UnicodeEncoding(True, True, True)
      Dim u16noED As New
 UnicodeEncoding(True, True, False)

      ' Create byte arrays from the same string containing the following
 characters:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    Latin Capital Letter U with  Diaeresis (U+00DC)
      Dim myStr As String
 = "za" & ChrW(&H0306) & ChrW(&H01FD)
 & ChrW(&H03B2) & ChrW(&H00DC)

      ' Encode the string using little-endian byte order.
      Dim myBytes(u16LE.GetByteCount(myStr)) As
 Byte
      u16LE.GetBytes(myStr, 0, myStr.Length, myBytes, 0)

      ' Decode the byte array with error detection.
      Console.WriteLine("Decoding with error detection:")
      PrintDecodedString(myBytes, u16withED)

      ' Decode the byte array without error detection.
      Console.WriteLine("Decoding without error detection:")
      PrintDecodedString(myBytes, u16noED)

   End Sub 'Main


   ' Decode the bytes and display the string.
   Public Shared Sub PrintDecodedString(bytes()
 As Byte, enc As Encoding)

      Try
         Console.WriteLine("   Decoded string: {0}",
 enc.GetString(bytes, 0, bytes.Length))
      Catch e As System.ArgumentException
         Console.WriteLine(e.ToString())
      End Try

      Console.WriteLine()

   End Sub 'PrintDecodedString
 

End Class 'SamplesUnicodeEncoding

using System;
using System.Text;

public class SamplesUnicodeEncoding  {

   public static void Main()
  {

      // Create an instance of UnicodeEncoding using little-endian byte
 order.
      // This will be used for encoding.
      UnicodeEncoding u16LE     = new UnicodeEncoding( false,
 true );

      // Create two instances of UnicodeEncoding using big-endian byte
 order: one with error detection and one without.
      // These will be used for decoding.
      UnicodeEncoding u16withED = new UnicodeEncoding( true,
 true, true );
      UnicodeEncoding u16noED   = new UnicodeEncoding( true,
 true, false );

      // Create byte arrays from the same string containing the following
 characters:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    Latin Capital Letter U with  Diaeresis (U+00DC)
      String myStr = "za\u0306\u01FD\u03B2\u00DC";

      // Encode the string using little-endian byte order.
      byte[] myBytes = new byte[u16LE.GetByteCount( myStr )];
      u16LE.GetBytes( myStr, 0, myStr.Length, myBytes, 0 );

      // Decode the byte array with error detection.
      Console.WriteLine( "Decoding with error detection:" );
      PrintDecodedString( myBytes, u16withED );

      // Decode the byte array without error detection.
      Console.WriteLine( "Decoding without error detection:" );
      PrintDecodedString( myBytes, u16noED );

   }


   // Decode the bytes and display the string.
   public static void PrintDecodedString(
 byte[] bytes, Encoding enc )  {

      try  {
         Console.WriteLine( "   Decoded string: {0}",
 enc.GetString( bytes, 0, bytes.Length ) );
      }
      catch ( System.ArgumentException e )  {
         Console.WriteLine( e.ToString() );
      }

      Console.WriteLine();

   }

}

using namespace System;
using namespace System::Text;
void PrintDecodedString( array<Byte>^bytes, Encoding^ enc
 );
int main()
{
   
   // Create an instance of UnicodeEncoding using little-endian byte
 order.
   // This will be used for encoding.
   UnicodeEncoding^ u16LE = gcnew UnicodeEncoding( false,true
 );
   
   // Create two instances of UnicodeEncoding using big-endian byte
 order: one with error detection and one without.
   // These will be used for decoding.
   UnicodeEncoding^ u16withED = gcnew UnicodeEncoding( true,true,true
 );
   UnicodeEncoding^ u16noED = gcnew UnicodeEncoding( true,true,false
 );
   
   // Create byte arrays from the same string containing the following
 characters:
   //    Latin Small Letter Z (U+007A)
   //    Latin Small Letter A (U+0061)
   //    Combining Breve (U+0306)
   //    Latin Small Letter AE With Acute (U+01FD)
   //    Greek Small Letter Beta (U+03B2)
   //    Latin Capital Letter U with  Diaeresis (U+00DC)
   String^ myStr = "za\u0306\u01FD\u03B2\u00DC";
   
   // Encode the string using little-endian byte order.
   array<Byte>^myBytes = gcnew array<Byte>(u16LE->GetByteCount( myStr
 ));
   u16LE->GetBytes( myStr, 0, myStr->Length, myBytes, 0 );
   
   // Decode the byte array with error detection.
   Console::WriteLine( "Decoding with error detection:" );
   PrintDecodedString( myBytes, u16withED );
   
   // Decode the byte array without error detection.
   Console::WriteLine( "Decoding without error detection:" );
   PrintDecodedString( myBytes, u16noED );
}


// Decode the bytes and display the string.
void PrintDecodedString( array<Byte>^bytes, Encoding^ enc
 )
{
   try
   {
      Console::WriteLine( "   Decoded string: {0}",
 enc->GetString( bytes, 0, bytes->Length ) );
   }
   catch ( System::ArgumentException^ e ) 
   {
      Console::WriteLine( e );
   }

   Console::WriteLine();
}

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

public class SamplesUnicodeEncoding
{
    public static void main(String[]
 args)
    {
        // Create an instance of UnicodeEncoding using little-endian
 
        // byte order.
        // This will be used for encoding.
        UnicodeEncoding u16LE = new UnicodeEncoding(false,
 true);

        // Create two instances of UnicodeEncoding using big-endian
 byte 
        // order: one with error detection and one without.
        // These will be used for decoding.
        UnicodeEncoding u16withED = new UnicodeEncoding(true,
 true, true);
        UnicodeEncoding u16noED = new UnicodeEncoding(true,
 true, false);

        // Create byte arrays from the same string containing 
        // the following characters:
        //    Latin Small Letter Z (U+007A)
        //    Latin Small Letter A (U+0061)
        //    Combining Breve (U+0306)
        //    Latin Small Letter AE With Acute (U+01FD)
        //    Greek Small Letter Beta (U+03B2)
        //    Latin Capital Letter U with  Diaeresis (U+00DC)
        String myStr = "za\u0306\u01FD\u03B2\u00DC";

        // Encode the string using little-endian byte order.
        ubyte myBytes[] = new ubyte[u16LE.GetByteCount(myStr)];
        u16LE.GetBytes(myStr, 0, myStr.get_Length(), myBytes, 0);

        // Decode the byte array with error detection.
        Console.WriteLine("Decoding with error detection:");
        PrintDecodedString(myBytes, u16withED);

        // Decode the byte array without error detection.
        Console.WriteLine("Decoding without error detection:");
        PrintDecodedString(myBytes, u16noED);
    } //main

    // Decode the bytes and display the string.
    public static void PrintDecodedString(ubyte[]
 bytes, Encoding enc)
    {
        try {
            Console.WriteLine("   Decoded string: {0}",
 
                enc.GetString(bytes, 0, bytes.length));
        }
        catch(System.ArgumentException e) {
            Console.WriteLine(e.toString());
        }
        Console.WriteLine();
    } //PrintDecodedString
} //SamplesUnicodeEncoding

プラットフォーム

プラットフォーム

バージョン情報

バージョン情報

.NET Framework
サポート対象 : 2.0

関連項目
UnicodeEncoding クラス
UnicodeEncoding メンバ
System.Text 名前空間
GetPreamble

UnicodeEncoding コンストラクタ

UnicodeEncoding クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
UnicodeEncoding ()	UnicodeEncoding クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
UnicodeEncoding (Boolean, Boolean)	UnicodeEncoding クラスの新しいインスタンスを初期化します。パラメータでは、ビッグエンディアンバイト順を使用するかどうか、および Unicode バイト順マークを付加するかどうかを指定します。 .NET Compact Framework によってサポートされています。
UnicodeEncoding (Boolean, Boolean, Boolean)	UnicodeEncoding クラスの新しいインスタンスを初期化します。パラメータでは、ビッグエンディアンバイト順を使用するかどうか、Unicode バイト順マークを付加するかどうか、および無効なエンコーディングを検出したときに例外をスローするかどうかを指定します。

関連項目

UnicodeEncoding クラス
UnicodeEncoding メンバ
System.Text 名前空間

UnicodeEncoding コンストラクタ ()

UnicodeEncoding クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New UnicodeEncoding

public UnicodeEncoding ()

public:
UnicodeEncoding ()

public UnicodeEncoding ()

public function UnicodeEncoding ()

このコンストラクタは、リトルエンディアンバイト順を使用し、Unicode バイト順マークを付加し、無効なエンコーディングを検出したときに例外をスローしないインスタンスを作成します。

注意
セキュリティ上の理由から、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 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 クラス
UnicodeEncoding メンバ
System.Text 名前空間

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

辞書ショートカット

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

カテゴリ一覧

＋ビジネス

＋業界用語

＋コンピュータ

＋自動車・バイク

＋船

＋建築・不動産

＋ヘルスケア

＋スポーツ

＋辞書・百科事典

すべての辞書の索引

Weblioのサービス

「UnicodeEncoding コンストラクタ」の関連用語

1

UnicodeEncoding コンストラクタ ()

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

58% |||||

2

UnicodeEncoding.GetPreamble メソッド

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

38% |||||

3

UnicodeEncoding クラス

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

36% |||||

4

UnmanagedMemoryStream コンストラクタ

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

34% |||||

5

UnicodeEncoding.GetDecoder メソッド

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

32% |||||

6

UnmanagedMemoryStream.CanWrite プロパティ

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

30% |||||

7

UTF7Encoding コンストラクタ ()

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

30% |||||

8

UnicodeEncoding.GetEncoder メソッド

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

30% |||||

9

UTF32Encoding メソッド

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

18% |||||

10

UnmanagedMemoryStream.CanRead プロパティ

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

18% |||||

UnicodeEncoding コンストラクタのお隣キーワード

UnicastIPAddressInformation メンバ

UnicodeCategory 列挙体

UnicodeEncoding クラス

UnicodeEncoding コンストラクタ

UnicodeEncoding フィールド

UnicodeEncoding プロパティ

UnicodeEncoding メソッド

UnicodeEncoding メンバ

UnicodeEncoding.CharSize フィールド

UnicodeEncoding.Equals メソッド

検索ランキング

UnicodeEncoding コンストラクタのページの著作権
Weblio 辞書情報提供元は参加元一覧にて確認できます。


	© 2025 Microsoft.All rights reserved.

ビジネス｜業界用語｜コンピュータ｜電車｜自動車・バイク｜船｜工学｜建築・不動産｜学問
 文化｜生活｜ヘルスケア｜趣味｜スポーツ｜生物｜食品｜人名｜方言｜辞書・百科事典

ご利用にあたって

・Weblio辞書とは

・検索の仕方

・利用規約

・プライバシーポリシー

・サイトマップ

便利な機能

・ウェブリオのアプリ

・画像から探す

お問合せ・ご要望

・お問い合わせ

会社概要

・公式企業ページ

・会社情報

・採用情報

ウェブリオのサービス

・Weblio 辞書

・類語・対義語辞典

・英和辞典・和英辞典

・Weblio翻訳

・日中中日辞典

・日韓韓日辞典

・フランス語辞典

・インドネシア語辞典

・タイ語辞典

・ベトナム語辞典

・古語辞典

・おすすめのプログラミングスクール情報「Livifun」

©2025 GRAS Group, Inc.RSS