UTF7Encoding Constructeurs

Définition

Espace de noms:

System.Text

Assembly:

System.Text.Encoding.Extensions.dll

Initialise une nouvelle instance de la classe UTF7Encoding.

Surcharges

UTF7Encoding()	Obsolète. Initialise une nouvelle instance de la classe UTF7Encoding.
UTF7Encoding(Boolean)	Obsolète. Initialise une nouvelle instance de la classe UTF7Encoding. Un paramètre spécifie si les caractères facultatifs sont autorisés.

UTF7Encoding()

Source:

UTF7Encoding.cs

Attention

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

Initialise une nouvelle instance de la classe 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 ()

Attributs

ObsoleteAttribute

Exemples

L’exemple de code suivant montre comment créer un instance UTF7Encoding et afficher le nom de l’encodage.

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

Remarques

Ce constructeur crée une instance qui n’autorise pas les caractères facultatifs. Appeler le UTF7Encoding constructeur revient à appeler le UTF7Encoding.UTF7Encoding(Boolean) constructeur qui prend un allowOptionals paramètre et à spécifier false pour ce paramètre.

Si un instance autorise des caractères facultatifs, les points de code Unicode sont encodés avec un caractère facultatif correspondant au lieu d’un caractère de base 64 modifié. Les caractères facultatifs sont le point d’exclamation (« ! »), la barre oblique vers l’arrière (« \ »), la ligne verticale (« | »), le guillemet double (« », le signe numérique (« # »), le signe dollar (« $ »), le signe de pourcentage (« % »), l’esperluette (« & »), l’astérisque (« * »), le point-virgule (« ; »), crochet gauche (« < »), crochet droit («  »), crochet droit (« > »), crochet en courbe gauche (« { »), crochet droit (« } »), crochet gauche (« [ »), crochet droit (« ] »), signe égal (« = »), signe égal (« @ »), accentuation circonflexe (« ^ »), trait de soulignement (« _ ») et accent grave (« ' »).

Notes

UTF7Encoding ne fournit pas de détection des erreurs. Pour des raisons de sécurité, il est recommandé à vos applications d’utiliser UTF8Encoding, UnicodeEncodingou et UTF32Encoding d’activer la détection des erreurs.

UTF7Encoding(Boolean)

Source:

UTF7Encoding.cs

Attention

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

Initialise une nouvelle instance de la classe UTF7Encoding. Un paramètre spécifie si les caractères facultatifs sont autorisés.

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

allowOptionals

Boolean

true pour spécifier que les caractères facultatifs sont autorisés ; sinon, false.

Attributs

ObsoleteAttribute

Exemples

L’exemple de code suivant montre comment créer un instance UTF7Encoding qui autorise les caractères facultatifs.

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

Remarques

Si un instance autorise des caractères facultatifs, les points de code Unicode sont encodés avec un caractère facultatif correspondant au lieu d’un caractère de base 64 modifié. Les caractères facultatifs sont le point d’exclamation (« ! »), la barre oblique vers l’arrière (« \ »), la ligne verticale (« | »), le guillemet double (« », le signe numérique (« # »), le signe dollar (« $ »), le signe de pourcentage (« % »), l’esperluette (« & »), l’astérisque (« * »), le point-virgule (« ; »), crochet gauche (« < »), crochet droit («  »), crochet droit (« > »), crochet en courbe gauche (« { »), crochet droit (« } »), crochet gauche (« [ »), crochet droit (« ] »), signe égal (« = »), signe égal (« @ »), accentuation circonflexe (« ^ »), trait de soulignement (« _ ») et accent grave (« ' »).

Notes

UTF7Encoding ne fournit pas de détection des erreurs. Pour des raisons de sécurité, il est recommandé à vos applications d’utiliser UTF8Encoding, UnicodeEncodingou et UTF32Encoding d’activer la détection des erreurs.