UTF8Encodingとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

UTF8Encoding クラス

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

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

Visual Basic (宣言)
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class UTF8Encoding
    Inherits Encoding
Visual Basic (使用法)
Dim instance As UTF8Encoding
C#
[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class UTF8Encoding : Encoding
C++
[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class UTF8Encoding : public
 Encoding
J#
/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class UTF8Encoding extends Encoding
JScript
SerializableAttribute 
ComVisibleAttribute(true) 
public class UTF8Encoding extends
 Encoding
解説解説

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

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

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

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

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

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

メモメモ

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

UTF8Encoding は、Windows コード ページ 65001 に対応しています。

メモメモ

オブジェクトのシリアル化と逆シリアル化を行う際に使用した .NET Framework のバージョンが異なる場合、UTF-8 でエンコードされたオブジェクトの状態は保持されません。

使用例使用例

次の例は、UTF8Encoding を使用して、Unicode 文字列をエンコードし、その結果をバイト配列に格納する方法を示しています。encodedBytes を文字列にデコードしても、データの損失は発生しません。

Visual Basic
Imports System
Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        ' Create a UTF-8 encoding.
        Dim utf8 As New
 UTF8Encoding()
        
        ' A Unicode string with two characters outside an 8-bit code
 range.
        Dim unicodeString As String
 = _
            "This unicode string contains two characters "
 & _
            "with codes outside an 8-bit code range, "
 & _
            "Pi (" & ChrW(928) & ")
 and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        
        ' Encode the string.
        Dim encodedBytes As Byte()
 = utf8.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
 = utf8.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class
C#
using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main()
 {
        // Create a UTF-8 encoding.
        UTF8Encoding utf8 = new UTF8Encoding();
        
        // A Unicode string with two characters outside an 8-bit code
 range.
        String unicodeString =
            "This unicode string contains two characters
 " +
            "with codes outside an 8-bit code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = utf8.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 = utf8.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()
{
   
   // Create a UTF-8 encoding.
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   
   // A Unicode string with two characters outside an 8-bit code range.
   String^ unicodeString = L"This unicode string contains
 two characters with codes outside an 8-bit code range, Pi (\u03a0) and Sigma (\u03a3).";
   Console::WriteLine( "Original string:" );
   Console::WriteLine( unicodeString );
   
   // Encode the string.
   array<Byte>^encodedBytes = utf8->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 = utf8->GetString( encodedBytes );
   Console::WriteLine();
   Console::WriteLine( "Decoded bytes:" );
   Console::WriteLine( decodedString );
}
J#
import System.*;
import System.Text.*;

class UTF8EncodingExample
{
    public static void main(String[]
 args)
    {
        // Create a UTF-8 encoding.
        UTF8Encoding utf8 = new UTF8Encoding();

        // A Unicode string with two characters outside an 8-bit code
 range.
        String unicodeString = "This unicode string contains
 two characters "
            + "with codes outside an 8-bit code range, " 
            + "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        ubyte encodedBytes[] = utf8.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 = utf8.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    } //main
} //UTF8EncodingExample
継承階層継承階層
System.Object
   System.Text.Encoding
    System.Text.UTF8Encoding
スレッド セーフスレッド セーフ
この型の 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
参照参照
関連項目
UTF8Encoding メンバ
System.Text 名前空間
Decoder クラス
Encoder クラス

UTF8Encoding コンストラクタ ()

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

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

Visual Basic (宣言)
Public Sub New
Visual Basic (使用法)
Dim instance As New UTF8Encoding
C#
public UTF8Encoding ()
C++
public:
UTF8Encoding ()
J#
public UTF8Encoding ()
JScript
public function UTF8Encoding ()
解説解説

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

注意に関するメモ注意

セキュリティ上の理由から、throwOnInvalidBytes パラメータを受け取るコンストラクタを使用して、このパラメータを true に設定することにより、エラー検出を有効にすることをお勧めします。

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

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

使用例使用例

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

Visual Basic
Imports System
Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New
 UTF8Encoding()
        Dim encodingName As String
 = utf8.EncodingName
        Console.WriteLine("Encoding name: " &
 encodingName)
    End Sub 'Main
End Class 'UTF8EncodingExample
C#
using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main()
 {
        UTF8Encoding utf8 = new UTF8Encoding();
        String encodingName = utf8.EncodingName;
        Console.WriteLine("Encoding name: " + encodingName);
    }
}
C++
using namespace System;
using namespace System::Text;
int main()
{
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   String^ encodingName = utf8->EncodingName;
   Console::WriteLine( "Encoding name: {0}", encodingName );
}
J#
import System.*;
import System.Text.*;

class UTF8EncodingExample
{
    public static void main(String[]
 args)
    {
        UTF8Encoding utf8 = new UTF8Encoding();
        String encodingName = utf8.get_EncodingName();
        Console.WriteLine(("Encoding name: " + encodingName));
    } //main
} //UTF8EncodingExample
プラットフォームプラットフォーム

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
参照参照
関連項目
UTF8Encoding クラス
UTF8Encoding メンバ
System.Text 名前空間
GetPreamble

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

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

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

Visual Basic (宣言)
Public Sub New ( _
    encoderShouldEmitUTF8Identifier As Boolean,
 _
    throwOnInvalidBytes As Boolean _
)
Visual Basic (使用法)
Dim encoderShouldEmitUTF8Identifier As Boolean
Dim throwOnInvalidBytes As Boolean

Dim instance As New UTF8Encoding(encoderShouldEmitUTF8Identifier,
 throwOnInvalidBytes)
C#
public UTF8Encoding (
    bool encoderShouldEmitUTF8Identifier,
    bool throwOnInvalidBytes
)
C++
public:
UTF8Encoding (
    bool encoderShouldEmitUTF8Identifier, 
    bool throwOnInvalidBytes
)
J#
public UTF8Encoding (
    boolean encoderShouldEmitUTF8Identifier, 
    boolean throwOnInvalidBytes
)
JScript
public function UTF8Encoding (
    encoderShouldEmitUTF8Identifier : boolean, 
    throwOnInvalidBytes : boolean
)

パラメータ

encoderShouldEmitUTF8Identifier

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

throwOnInvalidBytes

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

解説解説

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

注意に関するメモ注意

セキュリティ上の理由から、このコンストラクタを使用して UTF8Encoding クラスのインスタンスを作成し、throwOnInvalidBytes を true に設定することでエラー検出をオンにすることをお勧めします。

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

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

使用例使用例

次の例は、エンコーディング時に Unicode バイト順マーク プリフィックスを作成せず、無効なエンコーディングが検出された場合には例外をスローするよう指定して、新しい UTF8Encoding インスタンスを作成する方法を示しています。このコンストラクタの動作を、無効なエンコーディングが検出された場合でも例外をスローしない UTF8Encoding の既定のコンストラクタと比較してください。

Visual Basic
Imports System
Imports System.Text
Imports Microsoft.VisualBasic
'Imports Microsoft.VisualBasic.Strings

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New
 UTF8Encoding()
        Dim utf8ThrowException As New
 UTF8Encoding(False, True)
        
        ' This array contains two high surrogates in a row:
        ' ChrW(55297) and ChrW(55298).
        ' A high surrogate should be followed by a low surrogate.
        Dim chars() As Char
 = {"a"c, "b"c, "c"c,
 ChrW(55297), ChrW(55298), "d"c}
        
        ' The following method call will not throw an exception.
        Dim bytes As Byte()
 = utf8.GetBytes(chars)
        ShowArray(bytes)
        
        Try
            ' The following method call will throw an exception.
            bytes = utf8ThrowException.GetBytes(chars)
        Catch e As Exception
            Console.WriteLine("Exception raised. "
 + ControlChars.Cr + "Message: {0}", e.Message)
        End Try
    End Sub
    
    
    Public Shared Sub ShowArray(theArray
 As Array)
        Dim o As Object
        For Each o In  theArray
            Console.Write("[{0}]", o)
        Next o
        Console.WriteLine()
    End Sub
End Class
C#
using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main()
 {
        UTF8Encoding utf8 = new UTF8Encoding();
        UTF8Encoding utf8ThrowException = new UTF8Encoding(false,
 true);

        // This array contains two high surrogates in a row (\uD801,
 \uD802).
        // A high surrogate should be followed by a low surrogate.
        Char[] chars = new Char[] {'a', 'b', 'c', '\uD801', '\uD802',
 'd'};

        // The following method call will not throw an exception.
        Byte[] bytes = utf8.GetBytes(chars);
        ShowArray(bytes);

        try {
            // The following method call will throw an exception.
            bytes = utf8ThrowException.GetBytes(chars);
        } catch (Exception e) {
            Console.WriteLine("Exception raised. \nMessage: {0}", e.Message);
        }
    }

    public static void ShowArray(Array
 theArray) {
        foreach (Object o in theArray) {
            Console.Write("[{0}]", o);
        }
        Console.WriteLine();
    }
}
C++
using namespace System;
using namespace System::Text;
using namespace System::Collections;
void ShowArray( Array^ theArray )
{
   IEnumerator^ myEnum = theArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Object^ o = safe_cast<Object^>(myEnum->Current);
      Console::Write( "[{0}]", o );
   }

   Console::WriteLine();
}

int main()
{
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   UTF8Encoding^ utf8ThrowException = gcnew UTF8Encoding( false,true
 );
   
   // This array contains two high surrogates in a row (\uD801, \uD802).
   // A high surrogate should be followed by a low surrogate.
   array<Char>^chars = {'a','b','c',L'\xD801',L'\xD802','d'};
   
   // The following method call will not throw an exception.
   array<Byte>^bytes = utf8->GetBytes( chars );
   ShowArray( bytes );
   try
   {
      
      // The following method call will throw an exception.
      bytes = utf8ThrowException->GetBytes( chars );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception raised. \nMessage: {0}", e->Message
 );
   }

}
J#
import System.*;
import System.Text.*;

class UTF8EncodingExample
{
    public static void main(String[]
 args)
    {
        UTF8Encoding utf8 =  new UTF8Encoding();
        UTF8Encoding utf8ThrowException =  new UTF8Encoding(false,
 true);
      
        // This array contains two high surrogates in a row (\uD801,
 \uD802).
        // A high surrogate should be followed by a low surrogate.
        char chars[] = new char[]
 { 'a', 'b', 'c', '\uD801', '\uD802', 'd' };
   
        // The following method call will not throw an exception.
        ubyte bytes[] = utf8.GetBytes(chars);
           ShowArray(bytes);
        try {
             // The following method call will throw an exception.
            bytes = utf8ThrowException.GetBytes(chars);
        }
        catch(System.Exception  e) {
            Console.WriteLine("Exception raised. \nMessage: {0}", 
            e.get_Message());
        } 
    } //main
   
    public static void ShowArray(Array
 theArray) 
    {
        Object o = null;        
        for (int iCtr=0; iCtr < theArray.get_Count();
 iCtr++) {
            o = theArray.get_Item(iCtr);
            Console.Write("[{0}]", o);
        }
        Console.WriteLine();
    } //ShowArray
} //UTF8EncodingExample
プラットフォームプラットフォーム

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
参照参照
関連項目
UTF8Encoding クラス
UTF8Encoding メンバ
System.Text 名前空間
GetPreamble

UTF8Encoding コンストラクタ (Boolean)

UTF8Encoding クラスの新しいインスタンスを初期化します。パラメータでは、Unicode バイト順マークを付加するかどうかを指定します。

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

Visual Basic (宣言)
Public Sub New ( _
    encoderShouldEmitUTF8Identifier As Boolean
 _
)
Visual Basic (使用法)
Dim encoderShouldEmitUTF8Identifier As Boolean

Dim instance As New UTF8Encoding(encoderShouldEmitUTF8Identifier)
C#
public UTF8Encoding (
    bool encoderShouldEmitUTF8Identifier
)
C++
public:
UTF8Encoding (
    bool encoderShouldEmitUTF8Identifier
)
J#
public UTF8Encoding (
    boolean encoderShouldEmitUTF8Identifier
)
JScript
public function UTF8Encoding (
    encoderShouldEmitUTF8Identifier : boolean
)

パラメータ

encoderShouldEmitUTF8Identifier

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

解説解説

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

注意に関するメモ注意

セキュリティ上の理由から、throwOnInvalidBytes パラメータを受け取るコンストラクタを使用して、このパラメータを true に設定することにより、エラー検出を有効にすることをお勧めします。

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

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

使用例使用例

次の例は、エンコーディング時に Unicode バイト順マーク プリフィックスを作成するよう指定して、新しい UTF8Encoding インスタンスを作成する方法を示しています。GetPreamble メソッドは、Unicode バイト順マーク プリフィックスを返し、コンソールに表示します。既定のコンストラクタを使用して作成した UTF8Encoding には、Unicode バイト順マーク プリフィックスはありません。

Visual Basic
Imports System
Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New
 UTF8Encoding()
        Dim utf8EmitBOM As New
 UTF8Encoding(True)
        
        Console.WriteLine("utf8 preamble:")
        ShowArray(utf8.GetPreamble())
        
        Console.WriteLine("utf8EmitBOM:")
        ShowArray(utf8EmitBOM.GetPreamble())
    End Sub 'Main
    
    
    Public Shared Sub ShowArray(theArray
 As Array)
        Dim o As Object
        For Each o In  theArray
            Console.Write("[{0}]", o)
        Next o
        Console.WriteLine()
    End Sub 'ShowArray
End Class 'UTF8EncodingExample
C#
using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main()
 {
        UTF8Encoding utf8 = new UTF8Encoding();
        UTF8Encoding utf8EmitBOM = new UTF8Encoding(true);

        Console.WriteLine("utf8 preamble:");
        ShowArray(utf8.GetPreamble());

        Console.WriteLine("utf8EmitBOM:");
        ShowArray(utf8EmitBOM.GetPreamble());
    }

    public static void ShowArray(Array
 theArray) {
        foreach (Object o in theArray) {
            Console.Write("[{0}]", o);
        }
        Console.WriteLine();
    }
}
C++
using namespace System;
using namespace System::Text;
using namespace System::Collections;
void ShowArray( Array^ theArray )
{
   IEnumerator^ myEnum = theArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Object^ o = safe_cast<Object^>(myEnum->Current);
      Console::Write( "[{0}]", o );
   }

   Console::WriteLine();
}

int main()
{
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   UTF8Encoding^ utf8EmitBOM = gcnew UTF8Encoding( true );
   Console::WriteLine( "utf8 preamble:" );
   ShowArray( utf8->GetPreamble() );
   Console::WriteLine( "utf8EmitBOM:" );
   ShowArray( utf8EmitBOM->GetPreamble() );
}
J#
import System.*;
import System.Text.*;

class UTF8EncodingExample
{
    public static void main(String[]
 args)
    {
        UTF8Encoding utf8 = new UTF8Encoding();
        UTF8Encoding utf8EmitBOM = new UTF8Encoding(true);

        Console.WriteLine("utf8 preamble:");
        ShowArray(utf8.GetPreamble());
        Console.WriteLine("utf8EmitBOM:");
        ShowArray(utf8EmitBOM.GetPreamble());
    } //main

    public static void ShowArray(Array
 theArray)
    {
        Object o = null;
        for (int iCtr = 0; iCtr < theArray.get_Length();
 iCtr++) {
            o = theArray.get_Item(iCtr);
            Console.Write("[{0}]", o);
        }
        Console.WriteLine();
    } //ShowArray
} //UTF8EncodingExample
プラットフォームプラットフォーム

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
参照参照
関連項目
UTF8Encoding クラス
UTF8Encoding メンバ
System.Text 名前空間
GetPreamble

UTF8Encoding コンストラクタ

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

名前 説明
UTF8Encoding () UTF8Encoding クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

UTF8Encoding (Boolean) UTF8Encoding クラスの新しいインスタンスを初期化します。パラメータでは、Unicode バイト順マークを付加するかどうかを指定します。

.NET Compact Framework によってサポートされています。

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

.NET Compact Framework によってサポートされています。

参照参照

関連項目

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

UTF8Encoding プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ ASCII  ASCII (7 ビット) 文字セットのエンコーディングを取得します。 ( Encoding から継承されます。)
パブリック プロパティ BigEndianUnicode  ビッグ エンディアン バイト順を使用する UTF-16 形式のエンコーディングを取得します。 ( Encoding から継承されます。)
パブリック プロパティ BodyName  派生クラスでオーバーライドされた場合、メール エージェントの Body タグと共に使用できる現在のエンコーディングの名前を取得します。 ( Encoding から継承されます。)
パブリック プロパティ CodePage  派生クラスでオーバーライドされた場合、現在の Encoding のコード ページ ID を取得します。 ( Encoding から継承されます。)
パブリック プロパティ DecoderFallback  現在の Encoding オブジェクトの DecoderFallback オブジェクトを取得または設定します。 ( Encoding から継承されます。)
パブリック プロパティ Default  システムの現在の ANSI コード ページのエンコーディングを取得します。 ( Encoding から継承されます。)
パブリック プロパティ EncoderFallback  現在の Encoding オブジェクトの EncoderFallback オブジェクトを取得または設定します。 ( Encoding から継承されます。)
パブリック プロパティ EncodingName  派生クラスでオーバーライドされた場合、現在のエンコーディングについての記述を、ユーザーが判読できる形式で取得します。 ( Encoding から継承されます。)
パブリック プロパティ HeaderName  派生クラスでオーバーライドされた場合、メール エージェント ヘッダー タグと共に使用できる現在のエンコーディングの名前を取得します。 ( Encoding から継承されます。)
パブリック プロパティ IsBrowserDisplay  派生クラスでオーバーライドされた場合、ブラウザ クライアントが現在のエンコーディングを使用してコンテンツを表示できるかどうかを示す値を取得します。 ( Encoding から継承されます。)
パブリック プロパティ IsBrowserSave  派生クラスでオーバーライドされた場合、ブラウザ クライアントが現在のエンコーディングを使用してコンテンツを保存できるかどうかを示す値を取得します。 ( Encoding から継承されます。)
パブリック プロパティ IsMailNewsDisplay  派生クラスでオーバーライドされた場合、メール クライアントおよびニュース クライアントが現在のエンコーディングを使用してコンテンツを表示できるかどうかを示す値を取得します。 ( Encoding から継承されます。)
パブリック プロパティ IsMailNewsSave  派生クラスでオーバーライドされた場合、メール クライアントおよびニュース クライアントが現在のエンコーディングを使用してコンテンツを保存できるかどうかを示す値を取得します。 ( Encoding から継承されます。)
パブリック プロパティ IsReadOnly  派生クラスでオーバーライドされた場合、現在のエンコーディングが読み取り専用かどうかを示す値を取得します。 ( Encoding から継承されます。)
パブリック プロパティ IsSingleByte  派生クラスでオーバーライドされた場合、現在のエンコーディングが 1 バイトのコード ポイントを使用するかどうかを示す値を取得します。 ( Encoding から継承されます。)
パブリック プロパティ Unicode  リトル エンディアン バイト順を使用する UTF-16 形式のエンコーディングを取得します。 ( Encoding から継承されます。)
パブリック プロパティ UTF32  リトル エンディアン バイト順を使用する UTF-32 形式のエンコーディングを取得します。 ( Encoding から継承されます。)
パブリック プロパティ UTF7  UTF-7 形式のエンコーディングを取得します。 ( Encoding から継承されます。)
パブリック プロパティ UTF8  UTF-8 形式のエンコーディングを取得します。 ( Encoding から継承されます。)
パブリック プロパティ WebName  派生クラスでオーバーライドされた場合、現在のエンコーディングの IANA (Internet Assigned Numbers Authority) に登録されている名前を取得します。 ( Encoding から継承されます。)
パブリック プロパティ WindowsCodePage  派生クラスでオーバーライドされた場合、現在のエンコーディングに最も厳密に対応する Windows オペレーティング システムのコード ページを取得します。 ( Encoding から継承されます。)
参照参照

関連項目

UTF8Encoding クラス
System.Text 名前空間
Decoder クラス
Encoder クラス

UTF8Encoding メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Clone  派生クラスでオーバーライドされた場合、現在の Encoding オブジェクトの簡易コピーを作成します。 ( Encoding から継承されます。)
パブリック メソッド Convert  オーバーロードされます。 バイト配列を、あるエンコーディングから別のエンコーディングに変換します。 ( Encoding から継承されます。)
パブリック メソッド Equals オーバーロードされます。 オーバーライドされます。  
パブリック メソッド GetByteCount オーバーロードされます。 文字のセットをエンコードすることによって生成されるバイト数を計算します。
パブリック メソッド GetBytes オーバーロードされます。 文字のセットをバイト シーケンスにエンコードします。
パブリック メソッド GetCharCount オーバーロードされます。 バイト シーケンスをデコードすることによって生成される文字数を計算します。
パブリック メソッド GetChars オーバーロードされます。 バイト シーケンスを文字のセットにデコードします。
パブリック メソッド GetDecoder オーバーライドされます。 UTF-8 でエンコードされたバイト シーケンスを Unicode 文字のシーケンスに変換するデコーダを取得します。
パブリック メソッド GetEncoder オーバーライドされます。 Unicode 文字のシーケンスを UTF-8 でエンコードされたバイト シーケンスに変換するエンコーダを取得します。
パブリック メソッド GetEncoding  オーバーロードされます。 指定したコード ページのエンコーディングを返します。 ( Encoding から継承されます。)
パブリック メソッド GetEncodings  すべてのエンコーディングを格納する配列を返します。 ( Encoding から継承されます。)
パブリック メソッド GetHashCode オーバーライドされます。 現在のインスタンスのハッシュ コードを返します。
パブリック メソッド GetMaxByteCount オーバーライドされます。 指定した文字数をエンコードすることによって生成される最大バイト数を計算します。
パブリック メソッド GetMaxCharCount オーバーライドされます。 指定したバイト数をデコードすることによって生成される最大文字数を計算します。
パブリック メソッド GetPreamble オーバーライドされます。 このインスタンスのコンストラクタでバイト順マークを付加するよう指定した場合は、UTF-8 形式でエンコードされた Unicode バイト順マークを返します。
パブリック メソッド GetString オーバーロードされます。 バイト シーケンスを文字列にデコードします。
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド IsAlwaysNormalized  オーバーロードされます。 現在のエンコーディングが常に正規化されるかどうかを示す値を取得します。 ( Encoding から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
参照参照

関連項目

UTF8Encoding クラス
System.Text 名前空間
Decoder クラス
Encoder クラス

UTF8Encoding メンバ

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

UTF8Encoding データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド UTF8Encoding オーバーロードされます。 UTF8Encoding クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ ASCII  ASCII (7 ビット) 文字セットのエンコーディングを取得します。(Encoding から継承されます。)
パブリック プロパティ BigEndianUnicode  ビッグ エンディアン バイト順を使用する UTF-16 形式のエンコーディングを取得します。(Encoding から継承されます。)
パブリック プロパティ BodyName  派生クラスでオーバーライドされた場合、メール エージェントの Body タグと共に使用できる現在のエンコーディングの名前を取得します。(Encoding から継承されます。)
パブリック プロパティ CodePage  派生クラスでオーバーライドされた場合、現在の Encoding のコード ページ ID を取得します。(Encoding から継承されます。)
パブリック プロパティ DecoderFallback  現在の Encoding オブジェクトの DecoderFallback オブジェクトを取得または設定します。(Encoding から継承されます。)
パブリック プロパティ Default  システムの現在の ANSI コード ページのエンコーディングを取得します。(Encoding から継承されます。)
パブリック プロパティ EncoderFallback  現在の Encoding オブジェクトの EncoderFallback オブジェクトを取得または設定します。(Encoding から継承されます。)
パブリック プロパティ EncodingName  派生クラスでオーバーライドされた場合、現在のエンコーディングについての記述を、ユーザーが判読できる形式で取得します。(Encoding から継承されます。)
パブリック プロパティ HeaderName  派生クラスでオーバーライドされた場合、メール エージェント ヘッダー タグと共に使用できる現在のエンコーディングの名前を取得します。(Encoding から継承されます。)
パブリック プロパティ IsBrowserDisplay  派生クラスでオーバーライドされた場合、ブラウザ クライアントが現在のエンコーディングを使用してコンテンツを表示できるかどうかを示す値を取得します。(Encoding から継承されます。)
パブリック プロパティ IsBrowserSave  派生クラスでオーバーライドされた場合、ブラウザ クライアントが現在のエンコーディングを使用してコンテンツを保存できるかどうかを示す値を取得します。(Encoding から継承されます。)
パブリック プロパティ IsMailNewsDisplay  派生クラスでオーバーライドされた場合、メール クライアントおよびニュース クライアントが現在のエンコーディングを使用してコンテンツを表示できるかどうかを示す値を取得します。(Encoding から継承されます。)
パブリック プロパティ IsMailNewsSave  派生クラスでオーバーライドされた場合、メール クライアントおよびニュース クライアントが現在のエンコーディングを使用してコンテンツを保存できるかどうかを示す値を取得します。(Encoding から継承されます。)
パブリック プロパティ IsReadOnly  派生クラスでオーバーライドされた場合、現在のエンコーディングが読み取り専用かどうかを示す値を取得します。(Encoding から継承されます。)
パブリック プロパティ IsSingleByte  派生クラスでオーバーライドされた場合、現在のエンコーディングが 1 バイトのコード ポイントを使用するかどうかを示す値を取得します。(Encoding から継承されます。)
パブリック プロパティ Unicode  リトル エンディアン バイト順を使用する UTF-16 形式のエンコーディングを取得します。(Encoding から継承されます。)
パブリック プロパティ UTF32  リトル エンディアン バイト順を使用する UTF-32 形式のエンコーディングを取得します。(Encoding から継承されます。)
パブリック プロパティ UTF7  UTF-7 形式のエンコーディングを取得します。(Encoding から継承されます。)
パブリック プロパティ UTF8  UTF-8 形式のエンコーディングを取得します。(Encoding から継承されます。)
パブリック プロパティ WebName  派生クラスでオーバーライドされた場合、現在のエンコーディングの IANA (Internet Assigned Numbers Authority) に登録されている名前を取得します。(Encoding から継承されます。)
パブリック プロパティ WindowsCodePage  派生クラスでオーバーライドされた場合、現在のエンコーディングに最も厳密に対応する Windows オペレーティング システムのコード ページを取得します。(Encoding から継承されます。)
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Clone  派生クラスでオーバーライドされた場合、現在の Encoding オブジェクトの簡易コピーを作成します。 (Encoding から継承されます。)
パブリック メソッド Convert  オーバーロードされます。 バイト配列を、あるエンコーディングから別のエンコーディングに変換します。 (Encoding から継承されます。)
パブリック メソッド Equals オーバーロードされます。 オーバーライドされます。  
パブリック メソッド GetByteCount オーバーロードされます。 文字のセットをエンコードすることによって生成されるバイト数を計算します。
パブリック メソッド GetBytes オーバーロードされます。 文字のセットをバイト シーケンスにエンコードします。
パブリック メソッド GetCharCount オーバーロードされます。 バイト シーケンスをデコードすることによって生成される文字数を計算します。
パブリック メソッド GetChars オーバーロードされます。 バイト シーケンスを文字のセットにデコードします。
パブリック メソッド GetDecoder オーバーライドされます。 UTF-8 でエンコードされたバイト シーケンスを Unicode 文字のシーケンスに変換するデコーダを取得します。
パブリック メソッド GetEncoder オーバーライドされます。 Unicode 文字のシーケンスを UTF-8 でエンコードされたバイト シーケンスに変換するエンコーダを取得します。
パブリック メソッド GetEncoding  オーバーロードされます。 指定したコード ページのエンコーディングを返します。 (Encoding から継承されます。)
パブリック メソッド GetEncodings  すべてのエンコーディングを格納する配列を返します。 (Encoding から継承されます。)
パブリック メソッド GetHashCode オーバーライドされます。 現在のインスタンスのハッシュ コードを返します。
パブリック メソッド GetMaxByteCount オーバーライドされます。 指定した文字数をエンコードすることによって生成される最大バイト数を計算します。
パブリック メソッド GetMaxCharCount オーバーライドされます。 指定したバイト数をデコードすることによって生成される最大文字数を計算します。
パブリック メソッド GetPreamble オーバーライドされます。 このインスタンスのコンストラクタでバイト順マークを付加するよう指定した場合は、UTF-8 形式でエンコードされた Unicode バイト順マークを返します。
パブリック メソッド GetString オーバーロードされます。 バイト シーケンスを文字列にデコードします。
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド IsAlwaysNormalized  オーバーロードされます。 現在のエンコーディングが常に正規化されるかどうかを示す値を取得します。 (Encoding から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 (Object から継承されます。)
参照参照

関連項目

UTF8Encoding クラス
System.Text 名前空間
Decoder クラス
Encoder クラス

急上昇のことば

宇野重吉
あざとい
しました
について
因果応報

英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「UTF8Encoding」の関連用語

1
UTF8Encoding.Equals メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

2
UTF8Encoding.GetHashCode メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

3
UTF8Encoding.GetString メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

4
UTF8Encoding.GetBytes メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

5
UTF8Encoding.GetCharCount メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

6
UTF8Encoding コンストラクタ ()
.NET Framework クラス ライブラリ リファレンス
100% |||||

7
UTF8Encoding.GetByteCount メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

8
UTF8Encoding.GetChars メソッド
.NET Framework クラス ライブラリ リファレンス
100% |||||

9
UTF8Encoding.GetPreamble メソッド
.NET Framework クラス ライブラリ リファレンス
98% |||||

10
UTF8Encoding クラス
.NET Framework クラス ライブラリ リファレンス
96% |||||

UTF8Encodingのお隣キーワード

UTF7Encoding.GetDecoder メソッド

UTF7Encoding.GetEncoder メソッド

UTF7Encoding.GetHashCode メソッド

UTF7Encoding.GetMaxByteCount メソッド

UTF7Encoding.GetMaxCharCount メソッド

UTF7Encoding.GetString メソッド

UTF8Encoding

UTF8Encoding クラス

UTF8Encoding コンストラクタ

UTF8Encoding プロパティ

UTF8Encoding メソッド

UTF8Encoding メンバ

UTF8Encoding.Equals メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


UTF8Encodingのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS