UTF7Encoding コンストラクタ

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

UTF7Encoding コンストラクタ

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

名前	説明
UTF7Encoding ()	UTF7Encoding クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
UTF7Encoding (Boolean)	UTF7Encoding クラスの新しいインスタンスを初期化します。パラメータでは、省略可能な文字を許可するかどうかを指定します。 .NET Compact Framework によってサポートされています。

参照

関連項目

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

UTF7Encoding コンストラクタ (Boolean)

UTF7Encoding クラスの新しいインスタンスを初期化します。パラメータでは、省略可能な文字を許可するかどうかを指定します。

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

Visual Basic (宣言)

Public Sub New ( _
    allowOptionals As Boolean _
)

Visual Basic (使用法)

Dim allowOptionals As Boolean

Dim instance As New UTF7Encoding(allowOptionals)

C#

public UTF7Encoding (
    bool allowOptionals
)

C++

public:
UTF7Encoding (
    bool allowOptionals
)

J#

public UTF7Encoding (
    boolean allowOptionals
)

JScript

public function UTF7Encoding (
    allowOptionals : boolean
)

パラメータ

allowOptionals

省略文字を許可するよう指定する場合は true。それ以外の場合は false。

解説

インスタンスで省略可能な文字が許可されている場合、Unicode コード ポイントが、変更された Base64 文字ではなく、対応する省略可能な文字を使用してエンコードされます。省略可能な文字は、感嘆符 ("!")、バック スラッシュ ("\")、縦線 ("|")、二重引用符 (")、ナンバ記号 ("#")、ドル記号 ("$")、パーセント記号 ("%")、アンパサンド ("&")、アスタリスク ("*")、セミコロン (";")、左山かっこ ("<")、右山かっこ (">")、左中かっこ ("{")、右中かっこ ("}")、左角かっこ ("[")、右角かっこ ("]")、等号 ("=")、アット マーク ("@")、曲折アクセント ("^")、アンダースコア ("_")、および抑音アクセント ("`") です。

注意
UTF7Encoding にはエラー検出機能が用意されていません。セキュリティ上の理由から、UTF8Encoding、UnicodeEncoding、または UTF32Encoding を使用し、エラー検出を有効にすることをお勧めします。

使用例

次のコード例は、省略可能な文字を許可する新しい UTF7Encoding インスタンスを作成する方法を示しています。

Visual Basic

Imports System
Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        
        ' A few optional characters.
        Dim chars As String
 = "!@#$"
        
        ' The default Encoding does not allow optional characters.
        ' Alternate byte values are used.
        Dim utf7 As New
 UTF7Encoding()
        Dim bytes1 As Byte()
 = utf7.GetBytes(chars)
        
        Console.WriteLine("Default UTF7 Encoding:")
        ShowArray(bytes1)
        
        ' Convert back to characters.
        Console.WriteLine("Characters:")
        ShowArray(utf7.GetChars(bytes1))
        
        ' Now, allow optional characters.
        ' Optional characters are encoded with their normal code points.
        Dim utf7AllowOptionals As New
 UTF7Encoding(True)
        Dim bytes2 As Byte()
 = utf7AllowOptionals.GetBytes(chars)
        
        Console.WriteLine("UTF7 Encoding with optional characters
 allowed:")
        ShowArray(bytes2)
        
        ' Convert back to characters.
        Console.WriteLine("Characters:")
        ShowArray(utf7AllowOptionals.GetChars(bytes2))
    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 'UTF7EncodingExample

C#

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main()
 {

        // A few optional characters.
        string chars = "!@#$";

        // The default Encoding does not allow optional characters.
        // Alternate byte values are used.
        UTF7Encoding utf7 = new UTF7Encoding();
        Byte[] bytes1 = utf7.GetBytes(chars);
        
        Console.WriteLine("Default UTF7 Encoding:");
        ShowArray(bytes1);

        // Convert back to characters.
        Console.WriteLine("Characters:");
        ShowArray(utf7.GetChars(bytes1));

        // Now, allow optional characters.
        // Optional characters are encoded with their normal code points.
        UTF7Encoding utf7AllowOptionals = new UTF7Encoding(true);
        Byte[] bytes2 = utf7AllowOptionals.GetBytes(chars);
        
        Console.WriteLine("UTF7 Encoding with optional characters allowed:");
        ShowArray(bytes2);

        // Convert back to characters.
        Console.WriteLine("Characters:");
        ShowArray(utf7AllowOptionals.GetChars(bytes2));
    }

    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()
{
   
   // A few optional characters.
   String^ chars = "!@#$";
   
   // The default Encoding does not allow optional characters.
   // Alternate Byte values are used.
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   array<Byte>^bytes1 = utf7->GetBytes( chars );
   Console::WriteLine( "Default UTF7 Encoding:" );
   ShowArray( bytes1 );
   
   // Convert back to characters.
   Console::WriteLine( "Characters:" );
   ShowArray( utf7->GetChars( bytes1 ) );
   
   // Now, allow optional characters.
   // Optional characters are encoded with their normal code points.
   UTF7Encoding^ utf7AllowOptionals = gcnew UTF7Encoding( true
 );
   array<Byte>^bytes2 = utf7AllowOptionals->GetBytes( chars );
   Console::WriteLine( "UTF7 Encoding with optional characters allowed:"
 );
   ShowArray( bytes2 );
   
   // Convert back to characters.
   Console::WriteLine( "Characters:" );
   ShowArray( utf7AllowOptionals->GetChars( bytes2 ) );
}

J#

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

class EncodingExample
{
    public static void main(String[]
 args)
    {
        // A few optional characters.
        String chars = "!@#$";

        // The default Encoding does not allow optional characters.
        // Alternate byte values are used.
        UTF7Encoding utf7 = new UTF7Encoding();
        ubyte bytes1[] = utf7.GetBytes(chars);
        Console.WriteLine("Default UTF7 Encoding:");
        ShowArray(bytes1);

        // Convert back to characters.
        Console.WriteLine("Characters:");
        ShowArray(utf7.GetChars(bytes1));

        // Now, allow optional characters.
        // Optional characters are encoded with their normal code points.
        UTF7Encoding utf7AllowOptionals = new UTF7Encoding(true);
        ubyte bytes2[] = utf7AllowOptionals.GetBytes(chars);
        Console.WriteLine("UTF7 Encoding with optional characters allowed:");
        ShowArray(bytes2);

        // Convert back to characters.
        Console.WriteLine("Characters:");
        ShowArray(utf7AllowOptionals.GetChars(bytes2));
    } //main

    public static void ShowArray(Array
 theArray)
    {
        Object obj = null;
        for(int iCtr = 0; iCtr < theArray.get_Length();
 iCtr++) {
            obj = theArray.get_Item(iCtr);
            Console.Write("[{0}]", obj);
        }
        Console.WriteLine();
    } //ShowArray
} //EncodingExample

プラットフォーム

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

参照

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

UTF7Encoding コンストラクタ ()

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New UTF7Encoding

C#

public UTF7Encoding ()

C++

public:
UTF7Encoding ()

J#

public UTF7Encoding ()

JScript

public function UTF7Encoding ()

解説

このコンストラクタは、省略可能な文字を許可しないインスタンスを作成します。UTF7Encoding コンストラクタを呼び出すことは、allowOptionals パラメータを受け取り、このパラメータに false を指定した System.Text.UTF7Encoding(Boolean) コンストラクタを呼び出すことと同じです。

インスタンスで省略可能な文字が許可されている場合、Unicode コード ポイントが、変更された Base64 文字ではなく、対応する省略可能な文字を使用してエンコードされます。省略可能な文字は、感嘆符 ("!")、バック スラッシュ ("\")、縦線 ("|")、二重引用符 (")、ナンバ記号 ("#")、ドル記号 ("$")、パーセント記号 ("%")、アンパサンド ("&")、アスタリスク ("*")、セミコロン (";")、左山かっこ ("<")、右山かっこ (">")、左中かっこ ("{")、右中かっこ ("}")、左角かっこ ("[")、右角かっこ ("]")、等号 ("=")、アット マーク ("@")、曲折アクセント ("^")、アンダースコア ("_")、および抑音アクセント ("`") です。

注意
UTF7Encoding にはエラー検出機能が用意されていません。セキュリティ上の理由から、UTF8Encoding、UnicodeEncoding、または UTF32Encoding を使用し、エラー検出を有効にすることをお勧めします。

使用例

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

Visual Basic

Imports System
Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim utf7 As New
 UTF7Encoding()
        Dim encodingName As String
 = utf7.EncodingName
        Console.WriteLine("Encoding name: " &
 encodingName)
    End Sub 'Main
End Class 'UTF7EncodingExample

C#

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main()
 {
        UTF7Encoding utf7 = new UTF7Encoding();
        String encodingName = utf7.EncodingName;
        Console.WriteLine("Encoding name: " + encodingName);
    }
}

C++

using namespace System;
using namespace System::Text;
int main()
{
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   String^ encodingName = utf7->EncodingName;
   Console::WriteLine( "Encoding name: {0}", encodingName );
}

J#

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

class UTF7EncodingExample
{
    public static void main(String[]
 args)
    {
        UTF7Encoding utf7 = new UTF7Encoding();
        String encodingName = utf7.get_EncodingName();
        Console.WriteLine(("Encoding name: " + encodingName));
    } //main
} //UTF7EncodingExample

プラットフォーム

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

参照

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