UTF7Encoding Konstruktorok

Definíció

Névtér:

System.Text

Szerelvények:

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

Inicializálja a UTF7Encoding osztály új példányát.

Túlterhelések

Name	Description
UTF7Encoding()	Elavult. Inicializálja a UTF7Encoding osztály új példányát.
UTF7Encoding(Boolean)	Elavult. Inicializálja a UTF7Encoding osztály új példányát. A paraméter megadja, hogy engedélyezi-e a választható karaktereket.

UTF7Encoding()

Forrás:

UTF7Encoding.cs

Figyelemfelhívás

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

Inicializálja a UTF7Encoding osztály új példányát.

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

Attribútumok

ObsoleteAttribute

Példák

Az alábbi példakód bemutatja, hogyan hozhat létre új UTF7Encoding példányt, és hogyan jelenítheti meg a kódolás nevét.

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

Megjegyzések

Ez a konstruktor létrehoz egy példányt, amely nem engedélyezi a választható karaktereket. A UTF7Encoding konstruktor meghívása egyenértékű azzal, hogy meghívja azt a UTF7Encoding.UTF7Encoding(Boolean) konstruktort, amely egy paramétert allowOptionals vesz fel, és megadja false az adott paramétert.

Ha egy példány nem kötelező karaktereket engedélyez, a Unicode-kódpontok a módosított 64-es alapkarakterek helyett egy megfelelő választható karakterrel vannak kódolva. A választható karakterek a felkiáltójel ("!"), fordított perjel ("\"), függőleges vonal ("|"), kettős idézőjel (""""), számjel ("#"), dollárjel ("$"), százalékjel ("%"), ampersand ("&"), csillag ("*"), pontosvessző (";"), bal szög szögletes zárójel ("<"), szögletes zárójel (">"), bal oldali szögletes zárójel ("{"), jobb oldali szögletes zárójel ("}"), bal oldali szögletes zárójel ("["), jobb szögletes zárójel ("]"), egyenlőségjel ("="), at sign ("@"), circumflex accent ("^"), aláhúzás ("_"), és sírékezet (""").

Note

UTF7Encoding nem biztosít hibaészlelést. Biztonsági okokból javasoljuk, hogy az alkalmazásokat használja UTF8Encoding, UnicodeEncodingvagy UTF32Encoding engedélyezze a hibaészlelést.

UTF7Encoding(Boolean)

Forrás:

UTF7Encoding.cs

Figyelemfelhívás

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

Inicializálja a UTF7Encoding osztály új példányát. A paraméter megadja, hogy engedélyezi-e a választható karaktereket.

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)

Paraméterek

allowOptionals

Boolean

truea választható karakterek megadásához; egyéb esetben. false

Attribútumok

ObsoleteAttribute

Példák

Az alábbi példakód bemutatja, hogyan hozhat létre olyan új UTF7Encoding példányt, amely lehetővé teszi az opcionális karakterek használatát.

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

Megjegyzések

Ha egy példány nem kötelező karaktereket engedélyez, a Unicode-kódpontok a módosított 64-es alapkarakterek helyett egy megfelelő választható karakterrel vannak kódolva. A választható karakterek a felkiáltójel ("!"), fordított perjel ("\"), függőleges vonal ("|"), kettős idézőjel (""""), számjel ("#"), dollárjel ("$"), százalékjel ("%"), ampersand ("&"), csillag ("*"), pontosvessző (";"), bal szög szögletes zárójel ("<"), szögletes zárójel (">"), bal oldali szögletes zárójel ("{"), jobb oldali szögletes zárójel ("}"), bal oldali szögletes zárójel ("["), jobb szögletes zárójel ("]"), egyenlőségjel ("="), at sign ("@"), circumflex accent ("^"), aláhúzás ("_"), és sírékezet (""").

Note

UTF7Encoding nem biztosít hibaészlelést. Biztonsági okokból javasoljuk, hogy az alkalmazásokat használja UTF8Encoding, UnicodeEncodingvagy UTF32Encoding engedélyezze a hibaészlelést.