Ағылшын тілінде оқу

Бөлісу құралы:


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

Определение

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

Перегрузки

UTF7Encoding()
Устаревшие..

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

UTF7Encoding(Boolean)
Устаревшие..

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

UTF7Encoding()

Исходный код:
UTF7Encoding.cs
Исходный код:
UTF7Encoding.cs
Исходный код:
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 ();
Атрибуты

Примеры

В следующем примере кода показано, как создать новый 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);
    }
}

Комментарии

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

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

Ескерім

UTF7Encoding не обеспечивает обнаружение ошибок. В целях безопасности приложениям рекомендуется использовать UTF8Encoding, UnicodeEncodingили UTF32Encoding и включить обнаружение ошибок.

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар (Ескірген)
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1 (5, 6, 7, 8, 9)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

UTF7Encoding(Boolean)

Исходный код:
UTF7Encoding.cs
Исходный код:
UTF7Encoding.cs
Исходный код:
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);

Параметры

allowOptionals
Boolean

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

Атрибуты

Примеры

В следующем примере кода показано, как создать новый 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();
    }
}

Комментарии

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

Ескерім

UTF7Encoding не обеспечивает обнаружение ошибок. В целях безопасности приложениям рекомендуется использовать UTF8Encoding, UnicodeEncodingили UTF32Encoding и включить обнаружение ошибок.

Применяется к

.NET 9 және басқа нұсқалар
Өнім Нұсқалар (Ескірген)
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1 (5, 6, 7, 8, 9)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0