UTF7Encoding Конструкторы
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса UTF7Encoding.
UTF7Encoding() |
Устаревшие..
Инициализирует новый экземпляр класса UTF7Encoding. |
UTF7Encoding(Boolean) |
Устаревшие..
Инициализирует новый экземпляр класса 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();
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 ()
- Атрибуты
Примеры
В следующем примере кода показано, как создать новый UTF7Encoding экземпляр и отобразить имя кодировки.
using namespace System;
using namespace System::Text;
int main()
{
UTF7Encoding^ utf7 = gcnew UTF7Encoding;
String^ encodingName = utf7->EncodingName;
Console::WriteLine( "Encoding name: {0}", encodingName );
}
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. Необязательные символы: восклицательный знак ("!"), косая черта назад ("\"), вертикальная линия ("|"), двойная кавычка (""""), знак цифры ("#"), знак доллара ("$"), знак процента ("%"), амперсанд ("&"), звездочка ("*"), точка с запятой (";"), левая угловая скобка ("<"), правая угловая скобка (">"), левая фигурная скобка ("{"), правая фигурная скобка ("}"), левая квадратная скобка ("["), правая квадратная скобка ("]"), знак равенства ("="), знак равенства ("@"), диакритические знаки ("^"), подчеркивание ("_") и серьезный акцент ("'").
Ескерім
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.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);
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);
new System.Text.UTF7Encoding : bool -> System.Text.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}")>]
new System.Text.UTF7Encoding : bool -> System.Text.UTF7Encoding
Public Sub New (allowOptionals As Boolean)
Параметры
- allowOptionals
- Boolean
Значение true
указывает, что дополнительные символы разрешены; в противном случае используется значение false
.
- Атрибуты
Примеры
В следующем примере кода показано, как создать новый UTF7Encoding экземпляр, допускающий использование необязательных символов.
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 ) );
}
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. Необязательные символы: восклицательный знак ("!"), косая черта назад ("\"), вертикальная линия ("|"), двойная кавычка (""""), знак цифры ("#"), знак доллара ("$"), знак процента ("%"), амперсанд ("&"), звездочка ("*"), точка с запятой (";"), левая угловая скобка ("<"), правая угловая скобка (">"), левая фигурная скобка ("{"), правая фигурная скобка ("}"), левая квадратная скобка ("["), правая квадратная скобка ("]"), знак равенства ("="), знак равенства ("@"), диакритические знаки ("^"), подчеркивание ("_") и серьезный акцент ("'").
Ескерім
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 |
.NET кері байланысы
.NET — бастапқы коды ашық жоба. Пікір қалдыру үшін сілтемені таңдаңыз: