UTF7Encoding Costruttori

Definizione

Spazio dei nomi:

System.Text

Assembly:

System.Text.Encoding.Extensions.dll

Inizializza una nuova istanza della classe UTF7Encoding.

Overload

UTF7Encoding()	Obsoleti. Inizializza una nuova istanza della classe UTF7Encoding.
UTF7Encoding(Boolean)	Obsoleti. Inizializza una nuova istanza della classe UTF7Encoding. Un parametro specifica se consentire caratteri facoltativi.

UTF7Encoding()

Origine:

UTF7Encoding.cs

Attenzione

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

Inizializza una nuova istanza della 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 ()

Attributi

ObsoleteAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come creare una nuova UTF7Encoding istanza e visualizzare il nome della codifica.

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

Commenti

Questo costruttore crea un'istanza che non consente caratteri facoltativi. La chiamata al costruttore equivale a chiamare il UTF7Encoding.UTF7Encoding(Boolean)UTF7Encoding costruttore che accetta un allowOptionals parametro e specificare false per tale parametro.

Se un'istanza consente caratteri facoltativi, i punti di codice Unicode vengono codificati con un carattere facoltativo corrispondente anziché un carattere di base modificato 64. I caratteri facoltativi sono punto esclamativo ("!"), barra indietro ("\"), linea verticale ("|"), virgolette doppie ("""), segno di numero ("#"), segno di dollaro ("$"), segno di percentuale ("%"), ampersand ("&"), asterisco ("*"), punto e virgola (";"), sinistra parentesi< angolatura (">"), parentesi quadrata destra (""), parentesi graffe sinistra ("{"), parentesi quadre destra ("}"), parentesi quadrata sinistra ("["), parentesi quadrata destra ("]"), segno uguale ("="), segno uguale ("@"), all'segno ("@"), accento circonflesso ("^"), sottolineatura ("_"), e grave accento ("'").

Nota

UTF7Encoding non fornisce il rilevamento degli errori. Per motivi di sicurezza, è consigliabile usare UTF8Encoding, UnicodeEncodingo UTF32Encoding e abilitare il rilevamento degli errori.

UTF7Encoding(Boolean)

Origine:

UTF7Encoding.cs

Attenzione

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

Inizializza una nuova istanza della classe UTF7Encoding. Un parametro specifica se consentire caratteri facoltativi.

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)

Parametri

allowOptionals

Boolean

true per specificare che i caratteri facoltativi sono consentiti; in caso contrario, false.

Attributi

ObsoleteAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come creare una nuova UTF7Encoding istanza che consente caratteri facoltativi.

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

Commenti

Se un'istanza consente caratteri facoltativi, i punti di codice Unicode vengono codificati con un carattere facoltativo corrispondente anziché un carattere di base modificato 64. I caratteri facoltativi sono punto esclamativo ("!"), barra indietro ("\"), linea verticale ("|"), virgolette doppie ("""), segno di numero ("#"), segno di dollaro ("$"), segno di percentuale ("%"), ampersand ("&"), asterisco ("*"), punto e virgola (";"), sinistra parentesi< angolatura (">"), parentesi quadrata destra (""), parentesi graffe sinistra ("{"), parentesi quadre destra ("}"), parentesi quadrata sinistra ("["), parentesi quadrata destra ("]"), segno uguale ("="), segno uguale ("@"), all'segno ("@"), accento circonflesso ("^"), sottolineatura ("_"), e grave accento ("'").

Nota

UTF7Encoding non fornisce il rilevamento degli errori. Per motivi di sicurezza, è consigliabile usare UTF8Encoding, UnicodeEncodingo UTF32Encoding e abilitare il rilevamento degli errori.