Compartir a través de


UTF7Encoding Constructores

Definición

Inicializa una nueva instancia de la clase UTF7Encoding.

Sobrecargas

UTF7Encoding()
Obsoletos.

Inicializa una nueva instancia de la clase UTF7Encoding.

UTF7Encoding(Boolean)
Obsoletos.

Inicializa una nueva instancia de la clase UTF7Encoding. Un parámetro especifica si se permiten los caracteres opcionales.

UTF7Encoding()

Source:
UTF7Encoding.cs
Source:
UTF7Encoding.cs
Source:
UTF7Encoding.cs

Precaución

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

Inicializa una nueva instancia de la clase 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 ()
Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una nueva UTF7Encoding instancia y mostrar el nombre de la codificación.

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

Comentarios

Este constructor crea una instancia que no permite caracteres opcionales. Llamar al UTF7Encoding constructor equivale a llamar al UTF7Encoding.UTF7Encoding(Boolean) constructor que toma un allowOptionals parámetro y especifica false para ese parámetro.

Si una instancia permite caracteres opcionales, los puntos de código Unicode se codifican con un carácter opcional correspondiente en lugar de un carácter base 64 modificado. Los caracteres opcionales son signo de exclamación ("!"), barra diagonal hacia atrás ("\"), línea vertical ("|"), comilla doble ("""), signo de número ("#"), signo de dólar ("$"), signo de porcentaje ("%"), y comercial ("&"), asterisco ("*"), punto y coma (";"), izquierda corchete angular ("<"), corchete angular derecho (">"), corchete de curso izquierdo ("{"), corchete derecho ("}"), corchete derecho ("]"), signo igual ("="), signo igual ("="), acento circunflejo ("^"), subrayado ("_") y acento grave ("'").

Nota:

UTF7Encoding no proporciona detección de errores. Por motivos de seguridad, se recomienda que las aplicaciones usen UTF8Encoding, UnicodeEncodingo UTF32Encoding y habiliten la detección de errores.

Se aplica a

UTF7Encoding(Boolean)

Source:
UTF7Encoding.cs
Source:
UTF7Encoding.cs
Source:
UTF7Encoding.cs

Precaución

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

Inicializa una nueva instancia de la clase UTF7Encoding. Un parámetro especifica si se permiten los caracteres opcionales.

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)

Parámetros

allowOptionals
Boolean

Es true para especificar que se permiten caracteres opcionales; de lo contrario, es false.

Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una nueva UTF7Encoding instancia que permita caracteres opcionales.

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

Comentarios

Si una instancia permite caracteres opcionales, los puntos de código Unicode se codifican con un carácter opcional correspondiente en lugar de un carácter base 64 modificado. Los caracteres opcionales son signo de exclamación ("!"), barra diagonal hacia atrás ("\"), línea vertical ("|"), comilla doble ("""), signo de número ("#"), signo de dólar ("$"), signo de porcentaje ("%"), y comercial ("&"), asterisco ("*"), punto y coma (";"), izquierda corchete angular ("<"), corchete angular derecho (">"), corchete de curso izquierdo ("{"), corchete derecho ("}"), corchete derecho ("]"), signo igual ("="), signo igual ("="), acento circunflejo ("^"), subrayado ("_") y acento grave ("'").

Nota

UTF7Encoding no proporciona detección de errores. Por motivos de seguridad, se recomienda que las aplicaciones usen UTF8Encoding, UnicodeEncodingo UTF32Encoding y habiliten la detección de errores.

Se aplica a