UTF7Encoding Конструкторы

Определение

Пространство имен:

System.Text

Сборки:

netstandard.dll, System.Text.Encoding.Extensions.dll

Инициализирует новый экземпляр класса UTF7Encoding.

Перегрузки

Имя	Описание
UTF7Encoding()	Устаревшие. Инициализирует новый экземпляр класса UTF7Encoding.
UTF7Encoding(Boolean)	Устаревшие. Инициализирует новый экземпляр класса UTF7Encoding. Параметр указывает, следует ли разрешать необязательные символы.

UTF7Encoding()

Исходный код:

UTF7Encoding.cs

Внимание!

The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.

Инициализирует новый экземпляр класса UTF7Encoding.

public:
 UTF7Encoding();

[System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public UTF7Encoding();

Public Sub New ()

Атрибуты

ObsoleteAttribute

Примеры

В следующем примере кода показано, как создать новый UTF7Encoding экземпляр и отобразить имя кодирования.

using System;
using System.Text;

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

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

Комментарии

Этот конструктор создает экземпляр, который не разрешает необязательные символы. UTF7Encoding Вызов конструктора эквивалентен вызову конструктораUTF7Encoding.UTF7Encoding(Boolean), который принимает allowOptionals параметр и указывает false для этого параметра.

Если экземпляр разрешает необязательные символы, точки кода Юникода кодируются соответствующим необязательным символом вместо измененного базового 64 символа. Необязательные символы — восклицательный знак ("!"), обратная косая черта ("\"), вертикальная линия ("|"), двойная кавычка ("""), знак числа ("#"), знак доллара ("$"), знак процента ("%"), амперсанд ("&"), звездочка ("*"), точка с запятой (";"), слева угловая скобка (<""), правая угловая скобка (">"), левая фигурная скобка ("{"), левая квадратная скобка ("}"), левая квадратная скобка ("["), правый квадратный скобка ("]"), знак равенства ("="), знак равенства ("="), знак обрезания ("^"), подчеркивание ("_"), а также серьезный акцент ("").

Note

UTF7Encoding не предоставляет обнаружение ошибок. По соображениям безопасности приложения рекомендуется использовать UTF8EncodingUnicodeEncodingили UTF32Encoding включить обнаружение ошибок.

UTF7Encoding(Boolean)

Исходный код:

UTF7Encoding.cs

Внимание!

The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.

Инициализирует новый экземпляр класса UTF7Encoding. Параметр указывает, следует ли разрешать необязательные символы.

public:
 UTF7Encoding(bool allowOptionals);

[System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public UTF7Encoding(bool allowOptionals);

[<System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Text.UTF7Encoding : bool -> System.Text.UTF7Encoding

Public Sub New (allowOptionals As Boolean)

Параметры

allowOptionals

Boolean

true Значение , чтобы указать, разрешены ли необязательные символы; falseв противном случае .

Атрибуты

ObsoleteAttribute

Примеры

В следующем примере кода показано, как создать новый UTF7Encoding экземпляр, разрешающий необязательные символы.

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

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

Комментарии

Если экземпляр разрешает необязательные символы, точки кода Юникода кодируются соответствующим необязательным символом вместо измененного базового 64 символа. Необязательные символы — восклицательный знак ("!"), обратная косая черта ("\"), вертикальная линия ("|"), двойная кавычка ("""), знак числа ("#"), знак доллара ("$"), знак процента ("%"), амперсанд ("&"), звездочка ("*"), точка с запятой (";"), слева угловая скобка (<""), правая угловая скобка (">"), левая фигурная скобка ("{"), левая квадратная скобка ("}"), левая квадратная скобка ("["), правый квадратный скобка ("]"), знак равенства ("="), знак равенства ("="), знак обрезания ("^"), подчеркивание ("_"), а также серьезный акцент ("").

Note

UTF7Encoding не предоставляет обнаружение ошибок. По соображениям безопасности приложения рекомендуется использовать UTF8EncodingUnicodeEncodingили UTF32Encoding включить обнаружение ошибок.