UnicodeEncoding コンストラクター

定義

名前空間:: System.Text

アセンブリ:: mscorlib.dll, System.Text.Encoding.Extensions.dll

アセンブリ:: netstandard.dll, System.Text.Encoding.Extensions.dll

アセンブリ:: System.Text.Encoding.Extensions.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

名前	説明
UnicodeEncoding()	UnicodeEncoding クラスの新しいインスタンスを初期化します。
UnicodeEncoding(Boolean, Boolean)	UnicodeEncoding クラスの新しいインスタンスを初期化します。パラメーターは、ビッグエンディアンバイトオーダーを使用するかどうか、および GetPreamble() メソッドが Unicode バイトオーダーマークを返すかどうかを指定します。
UnicodeEncoding(Boolean, Boolean, Boolean)	UnicodeEncoding クラスの新しいインスタンスを初期化します。パラメーターは、ビッグエンディアンバイトオーダーを使用するかどうか、Unicode バイトオーダーマークを指定するかどうか、および無効なエンコードが検出されたときに例外をスローするかどうかを指定します。

UnicodeEncoding()

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

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

public:
 UnicodeEncoding();

public UnicodeEncoding();

Public Sub New ()

例

次の例では、新しい UnicodeEncoding インスタンスを作成し、エンコードの名前を表示する方法を示します。

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        UnicodeEncoding unicode = new UnicodeEncoding();
        String encodingName = unicode.EncodingName;
        Console.WriteLine("Encoding name: " + encodingName);
    }
}

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
End Class

注釈

このコンストラクターは、リトルエンディアンバイトオーダーを使用し、Unicode バイトオーダーマークを提供し、無効なエンコードが検出されたときに例外をスローしないインスタンスを作成します。

Caution

セキュリティ上の理由から、 UnicodeEncoding(Boolean, Boolean, Boolean) コンストラクターを呼び出し、その throwOnInvalidBytes 引数を true に設定することで、エラー検出を有効にする必要があります。

適用対象

UnicodeEncoding(Boolean, Boolean)

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

UnicodeEncoding クラスの新しいインスタンスを初期化します。パラメーターは、ビッグエンディアンバイトオーダーを使用するかどうか、および GetPreamble() メソッドが Unicode バイトオーダーマークを返すかどうかを指定します。

public:
 UnicodeEncoding(bool bigEndian, bool byteOrderMark);

public UnicodeEncoding(bool bigEndian, bool byteOrderMark);

new System.Text.UnicodeEncoding : bool * bool -> System.Text.UnicodeEncoding

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

パラメーター

bigEndian: Boolean

true ビッグエンディアンバイト順 (最上位バイト優先) を使用する場合は false 、リトルエンディアンバイト順 (最下位バイト優先) を使用する場合は。

byteOrderMark: Boolean

true GetPreamble() メソッドが Unicode バイトオーダーマークを返すように指定する場合は。それ以外の場合はfalse。

例

次の例では、リトルエンディアンとビッグエンディアンのどちらのバイト順序と Unicode バイトオーダーマークをサポートするかを指定する新しい UnicodeEncoding インスタンスを作成する方法を示します。

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")
        );
    }
}

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

注釈

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

Caution

byteOrderMark パラメーターは、GetPreamble メソッドの操作を制御します。 true場合、メソッドは UNICODE バイトオーダーマーク (BOM) を含むバイト配列を UTF-16 形式で返します。 false場合は、長さ 0 のバイト配列を返します。ただし、 byteOrderMark を true に設定しても、 GetBytes メソッドはバイト配列の先頭に BOM のプレフィックスを付けることはなく、また、 GetByteCount メソッドがバイト数に BOM のバイト数を含めることはありません。

こちらもご覧ください

GetPreamble()

適用対象

UnicodeEncoding(Boolean, Boolean, Boolean)

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

ソース:: UnicodeEncoding.cs

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

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

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

new System.Text.UnicodeEncoding : bool * bool * bool -> System.Text.UnicodeEncoding

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

パラメーター

bigEndian: Boolean

true ビッグエンディアンバイト順 (最上位バイト優先) を使用する場合。リトルエンディアンバイト順 (先頭に最下位バイト) を使用する false 。

byteOrderMark: Boolean

true GetPreamble() メソッドが Unicode バイトオーダーマークを返すように指定する場合は。それ以外の場合はfalse。

throwOnInvalidBytes: Boolean

true 無効なエンコードが検出されたときに例外をスローするように指定する場合。それ以外の場合は false。

例

次の例では、エラー検出を有効にした場合と無効にした場合の両方で、 UnicodeEncodingの動作を示します。

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();
   }
}

Imports System.Text

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


   ' 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

End Class

注釈

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

Caution

セキュリティ上の理由から、このコンストラクターを使用して UnicodeEncoding クラスのインスタンスを作成し、 throwOnInvalidBytes を true に設定してエラー検出を有効にする必要があります。

こちらもご覧ください

GetPreamble()

適用対象

フィードバック

このページはお役に立ちましたか?