UTF7Encoding Construtores

Definição

Namespace:

System.Text

Assembly:

System.Text.Encoding.Extensions.dll

Inicializa uma nova instância da classe UTF7Encoding.

Sobrecargas

UTF7Encoding()	Obsoleto. Inicializa uma nova instância da classe UTF7Encoding.
UTF7Encoding(Boolean)	Obsoleto. Inicializa uma nova instância da classe UTF7Encoding. Um parâmetro especifica se devem ser permitidos caracteres opcionais.

UTF7Encoding()

Origem:

UTF7Encoding.cs

Cuidado

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

Inicializa uma nova instância da 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 ()

Atributos

ObsoleteAttribute

Exemplos

O exemplo de código a seguir demonstra como criar uma nova UTF7Encoding instância e exibir o nome da codificação.

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

Comentários

Esse construtor cria uma instância que não permite caracteres opcionais. Chamar o UTF7Encoding construtor é equivalente a chamar o UTF7Encoding.UTF7Encoding(Boolean) construtor que usa um allowOptionals parâmetro e especificar false para esse parâmetro.

Se uma instância permitir caracteres opcionais, os pontos de código Unicode serão codificados com um caractere opcional correspondente em vez de um caractere base 64 modificado. Os caracteres opcionais são ponto de exclamação ("!"), barra para trás ("\"), linha vertical ("|"), aspas duplas ("""), sinal numérico ("#"), sinal de dólar ("$"), sinal de porcentagem ("%"), e comercial ("&"), asterisco ("*"), ponto e vírgula (";"), ângulo esquerdo colchete ("<"), colchete de ângulo direito (">"), colchete direito ("{"), colchete direito ("}"), colchete esquerdo ("["), colchete direito ("]"), sinal de igual ("="), sinal de sinal ("@"), ênfase circunflexo ("^"), sublinhado ("_"), e ênfase grave ("'").

Observação

UTF7Encoding não fornece detecção de erros. Por motivos de segurança, seus aplicativos são recomendados para usar UTF8Encoding, UnicodeEncodingou UTF32Encoding e habilitar a detecção de erros.

UTF7Encoding(Boolean)

Origem:

UTF7Encoding.cs

Cuidado

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

Inicializa uma nova instância da classe UTF7Encoding. Um parâmetro especifica se devem ser permitidos caracteres opcionais.

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)

Parâmetros

allowOptionals

Boolean

true para especificar que são permitidos caracteres opcionais, caso contrário, false.

Atributos

ObsoleteAttribute

Exemplos

O exemplo de código a seguir demonstra como criar uma nova UTF7Encoding instância que permite caracteres opcionais.

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

Comentários

Se uma instância permitir caracteres opcionais, os pontos de código Unicode serão codificados com um caractere opcional correspondente em vez de um caractere base 64 modificado. Os caracteres opcionais são ponto de exclamação ("!"), barra para trás ("\"), linha vertical ("|"), aspas duplas ("""), sinal numérico ("#"), sinal de dólar ("$"), sinal de porcentagem ("%"), e comercial ("&"), asterisco ("*"), ponto e vírgula (";"), ângulo esquerdo colchete ("<"), colchete de ângulo direito (">"), colchete direito ("{"), colchete direito ("}"), colchete esquerdo ("["), colchete direito ("]"), sinal de igual ("="), sinal de sinal ("@"), ênfase circunflexo ("^"), sublinhado ("_"), e ênfase grave ("'").

Observação

UTF7Encoding não fornece detecção de erros. Por motivos de segurança, seus aplicativos são recomendados para usar UTF8Encoding, UnicodeEncodingou UTF32Encoding e habilitar a detecção de erros.