UTF7Encoding クラスの新しいインスタンスを初期化します。パラメータでは、省略可能な文字を許可するかどうかを指定します。
名前空間: System.Text
アセンブリ: mscorlib (mscorlib.dll 内)
構文
'宣言
Public Sub New ( _
allowOptionals As Boolean _
)
'使用
Dim allowOptionals As Boolean
Dim instance As New UTF7Encoding(allowOptionals)
public UTF7Encoding (
bool allowOptionals
)
public:
UTF7Encoding (
bool allowOptionals
)
public UTF7Encoding (
boolean allowOptionals
)
public function UTF7Encoding (
allowOptionals : boolean
)
適用できません。
パラメータ
- allowOptionals
省略文字を許可するよう指定する場合は true。それ以外の場合は false。
解説
インスタンスで省略可能な文字が許可されている場合、Unicode コード ポイントが、変更された Base64 文字ではなく、対応する省略可能な文字を使用してエンコードされます。省略可能な文字は、感嘆符 ("!")、バック スラッシュ ("\")、縦線 ("|")、二重引用符 (")、ナンバ記号 ("#")、ドル記号 ("$")、パーセント記号 ("%")、アンパサンド ("&")、アスタリスク ("*")、セミコロン (";")、左山かっこ ("<")、右山かっこ (">")、左中かっこ ("{")、右中かっこ ("}")、左角かっこ ("[")、右角かっこ ("]")、等号 ("=")、アット マーク ("@")、曲折アクセント ("^")、アンダースコア ("_")、および抑音アクセント ("`") です。
.gif) 注意 : |
|---|
UTF7Encoding にはエラー検出機能が用意されていません。セキュリティ上の理由から、UTF8Encoding、UnicodeEncoding、または UTF32Encoding を使用し、エラー検出を有効にすることをお勧めします。 |
使用例
次のコード例は、省略可能な文字を許可する新しい UTF7Encoding インスタンスを作成する方法を示しています。
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
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();
}
}
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 ) );
}
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 Server 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
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0
.NET Compact Framework
サポート対象 : 2.0,1.0
XNA Framework
サポート対象 : 1.0