ASCIIEncoding Clase

Definición

Espacio de nombres:

System.Text

Ensamblado:

System.Text.Encoding.Extensions.dll

Source:

ASCIIEncoding.cs

Representa una codificación de caracteres ASCII de caracteres Unicode.

public ref class ASCIIEncoding : System::Text::Encoding

public class ASCIIEncoding : System.Text.Encoding

type ASCIIEncoding = class
    inherit Encoding

Public Class ASCIIEncoding
Inherits Encoding

Herencia

Object

Encoding

ASCIIEncoding

Ejemplos

En el ejemplo siguiente se muestra cómo codificar caracteres Unicode en ASCII. Observe la pérdida de datos que se produce cuando la aplicación usa ASCIIEncoding para codificar caracteres Unicode fuera del intervalo ASCII.

using namespace System;
using namespace System::Collections;
using namespace System::Text;
int main()
{
   
   // The encoding.
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   
   // A Unicode string with two characters outside the ASCII code range.
   String^ unicodeString = L"This Unicode String* contains two characters with codes outside the ASCII code range, Pi (\u03a0) and Sigma (\u03a3).";
   Console::WriteLine( "Original String*:" );
   Console::WriteLine( unicodeString );
   
   // Save positions of the special characters for later reference.
   int indexOfPi = unicodeString->IndexOf( L'\u03a0' );
   int indexOfSigma = unicodeString->IndexOf( L'\u03a3' );
   
   // Encode string.
   array<Byte>^encodedBytes = ascii->GetBytes( unicodeString );
   Console::WriteLine();
   Console::WriteLine( "Encoded bytes:" );
   IEnumerator^ myEnum = encodedBytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "->Item[ {0}]", b );
   }

   Console::WriteLine();
   
   // Notice that the special characters have been replaced with
   // the value 63, which is the ASCII character code for '?'.
   Console::WriteLine();
   Console::WriteLine( "Value at position of Pi character: {0}", encodedBytes[ indexOfPi ] );
   Console::WriteLine( "Value at position of Sigma character: {0}", encodedBytes[ indexOfSigma ] );
   
   // Decode bytes back to string.
   // Notice missing Pi and Sigma characters.
   String^ decodedString = ascii->GetString( encodedBytes );
   Console::WriteLine();
   Console::WriteLine( "Decoded bytes:" );
   Console::WriteLine( decodedString );
}
// The example displays the following output:
//    Original string:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (Π) and Sigma (Σ).
//
//    Encoded bytes:
//    [84][104][105][115][32][85][110][105][99][111][100][101][32][115][116][114][105]
//    [110][103][32][99][111][110][116][97][105][110][115][32][116][119][111][32][99][
//    104][97][114][97][99][116][101][114][115][32][119][105][116][104][32][99][111][1
//    00][101][115][32][111][117][116][115][105][100][101][32][116][104][101][32][65][
//    83][67][73][73][32][99][111][100][101][32][114][97][110][103][101][44][32][80][1
//    05][32][40][63][41][32][97][110][100][32][83][105][103][109][97][32][40][63][41]
//    [46]
//
//    Value at position of Pi character: 63
//    Value at position of Sigma character: 63
//
//    Decoded bytes:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (?) and Sigma (?).

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        // The encoding.
        ASCIIEncoding ascii = new ASCIIEncoding();
        
        // A Unicode string with two characters outside the ASCII code range.
        String unicodeString =
            "This Unicode string contains two characters " +
            "with codes outside the ASCII code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Save positions of the special characters for later reference.
        int indexOfPi = unicodeString.IndexOf('\u03a0');
        int indexOfSigma = unicodeString.IndexOf('\u03a3');

        // Encode string.
        Byte[] encodedBytes = ascii.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
        
        // Notice that the special characters have been replaced with
        // the value 63, which is the ASCII character code for '?'.
        Console.WriteLine();
        Console.WriteLine(
            "Value at position of Pi character: {0}",
            encodedBytes[indexOfPi]
        );
        Console.WriteLine(
            "Value at position of Sigma character: {0}",
            encodedBytes[indexOfSigma]
        );

        // Decode bytes back to string.
        // Notice missing Pi and Sigma characters.
        String decodedString = ascii.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}
// The example displays the following output:
//    Original string:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (Π) and Sigma (Σ).
//
//    Encoded bytes:
//    [84][104][105][115][32][85][110][105][99][111][100][101][32][115][116][114][105]
//    [110][103][32][99][111][110][116][97][105][110][115][32][116][119][111][32][99][
//    104][97][114][97][99][116][101][114][115][32][119][105][116][104][32][99][111][1
//    00][101][115][32][111][117][116][115][105][100][101][32][116][104][101][32][65][
//    83][67][73][73][32][99][111][100][101][32][114][97][110][103][101][44][32][80][1
//    05][32][40][63][41][32][97][110][100][32][83][105][103][109][97][32][40][63][41]
//    [46]
//
//    Value at position of Pi character: 63
//    Value at position of Sigma character: 63
//
//    Decoded bytes:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (?) and Sigma (?).

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        ' The encoding.
        Dim ascii As New ASCIIEncoding()

        ' A Unicode string with two characters outside the ASCII code range.
        Dim unicodeString As String = _
            "This Unicode string contains two characters " & _
            "with codes outside the ASCII code range, " & _
            "Pi (" & ChrW(928) & ") and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)

        ' Save positions of the special characters for later reference.
        Dim indexOfPi As Integer = unicodeString.IndexOf(ChrW(928))
        Dim indexOfSigma As Integer = unicodeString.IndexOf(ChrW(931))

        ' Encode string.
        Dim encodedBytes As Byte() = ascii.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Dim b As Byte
        For Each b In encodedBytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()

        ' Notice that the special characters have been replaced with
        ' the value 63, which is the ASCII character code for '?'.
        Console.WriteLine()
        Console.WriteLine( _
            "Value at position of Pi character: {0}", _
            encodedBytes(indexOfPi) _
        )
        Console.WriteLine( _
            "Value at position of Sigma character: {0}", _
            encodedBytes(indexOfSigma) _
        )

        ' Decode bytes back to string.
        ' Notice missing Pi and Sigma characters.
        Dim decodedString As String = ascii.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class
' The example displays the following output:
'    Original string:
'    This Unicode string contains two characters with codes outside the ASCII code ra
'    nge, Pi (Π) and Sigma (Σ).
'
'    Encoded bytes:
'    [84][104][105][115][32][85][110][105][99][111][100][101][32][115][116][114][105]
'    [110][103][32][99][111][110][116][97][105][110][115][32][116][119][111][32][99][
'    104][97][114][97][99][116][101][114][115][32][119][105][116][104][32][99][111][1
'    00][101][115][32][111][117][116][115][105][100][101][32][116][104][101][32][65][
'    83][67][73][73][32][99][111][100][101][32][114][97][110][103][101][44][32][80][1
'    05][32][40][63][41][32][97][110][100][32][83][105][103][109][97][32][40][63][41]
'    [46]
'
'    Value at position of Pi character: 63
'    Value at position of Sigma character: 63
'
'    Decoded bytes:
'    This Unicode string contains two characters with codes outside the ASCII code ra
'    nge, Pi (?) and Sigma (?).

Comentarios

Codificar es el proceso de transformar un conjunto de caracteres Unicode en una secuencia de bytes. La descodificación es el proceso de transformar una secuencia de bytes codificados en un conjunto de caracteres Unicode.

ASCIIEncoding corresponde a la página de códigos de Windows 20127. Dado que ASCII es una codificación de 7 bits, los caracteres ASCII se limitan a los 128 caracteres Unicode más bajos, de U+0000 a U+007F. Si usa el codificador predeterminado devuelto por la Encoding.ASCII propiedad o el ASCIIEncoding constructor, los caracteres fuera de ese intervalo se reemplazan por un signo de interrogación (?) antes de que se realice la operación de codificación. Dado que la ASCIIEncoding clase solo admite un juego de caracteres limitado, las UTF8Encodingclases , UnicodeEncodingy UTF32Encoding son más adecuadas para las aplicaciones globalizadas. Las consideraciones siguientes pueden ayudarle a decidir si usar ASCIIEncoding:

• Algunos protocolos requieren ASCII o un subconjunto de ASCII. En estos casos, la codificación ASCII es adecuada.

• Si se espera una codificación de 8 bits, es probable que ASCII no sea la opción correcta. En su lugar, considere la posibilidad de usar UTF8 en lugar de ASCII. Para los caracteres U+0000 a U+007F, los resultados son idénticos, pero todos los caracteres Unicode se pueden representar en UTF-8, lo que evita la pérdida de datos.

Precaución

ASCIIEncoding no proporciona detección de errores. Por motivos de seguridad, debe usar UTF8Encoding, UnicodeEncodingo UTF32Encoding y habilitar la detección de errores.

El GetByteCount método determina el número de bytes que dan como resultado la codificación de un conjunto de caracteres Unicode y el GetBytes método realiza la codificación real.

Del mismo modo, el GetCharCount método determina cuántos caracteres dan como resultado la descodificación de una secuencia de bytes, y los GetChars métodos y GetString realizan la descodificación real.

Tenga en cuenta que el constructor predeterminado ASCIIEncoding por sí mismo podría no tener el comportamiento adecuado para la aplicación. Es posible que quiera considerar la posibilidad de establecer la EncoderFallback propiedad EncoderExceptionFallback o DecoderFallback en o DecoderExceptionFallback para evitar secuencias con el conjunto de bits 8. El comportamiento personalizado también puede ser adecuado para estos casos.

Constructores

ASCIIEncoding()

Inicializa una nueva instancia de la clase ASCIIEncoding.

Propiedades

BodyName	Cuando se reemplaza en una clase derivada, obtiene un nombre para la codificación actual que se puede utilizar con etiquetas de cuerpo de un programa de correo. (Heredado de Encoding)
CodePage	Cuando se reemplaza en una clase derivada, obtiene el identificador de la página de códigos de la clase Encoding actual. (Heredado de Encoding)
DecoderFallback	Obtiene o establece el objeto DecoderFallback para el objeto Encoding actual. (Heredado de Encoding)
EncoderFallback	Obtiene o establece el objeto EncoderFallback para el objeto Encoding actual. (Heredado de Encoding)
EncodingName	Cuando se reemplaza en una clase derivada, obtiene la descripción inteligible de la codificación actual. (Heredado de Encoding)
HeaderName	Cuando se reemplaza en una clase derivada, obtiene un nombre para la codificación actual que se puede utilizar con etiquetas de encabezado de un programa de correo. (Heredado de Encoding)
IsBrowserDisplay	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si los clientes del explorador pueden utilizar la codificación actual para mostrar el contenido. (Heredado de Encoding)
IsBrowserSave	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si los clientes del explorador pueden utilizar la codificación actual para guardar el contenido. (Heredado de Encoding)
IsMailNewsDisplay	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si los clientes de correo y de noticias pueden utilizar la codificación actual para mostrar el contenido. (Heredado de Encoding)
IsMailNewsSave	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si los clientes de correo y de noticias pueden utilizar la codificación actual para guardar el contenido. (Heredado de Encoding)
IsReadOnly	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual es de solo lectura. (Heredado de Encoding)
IsSingleByte	Obtiene un valor que indica si la codificación actual utiliza puntos de código de un solo byte.
Preamble	Cuando se invalida en una clase derivada, devuelve un intervalo que contiene la secuencia de bytes que especifica la codificación utilizada. (Heredado de Encoding)
WebName	Cuando se reemplaza en una clase derivada, obtiene el nombre registrado en IANA (Internet Assigned Numbers Authority) para la codificación actual. (Heredado de Encoding)
WindowsCodePage	Cuando se reemplaza en una clase derivada, obtiene la página de códigos del sistema operativo Windows que se corresponde mejor con la codificación actual. (Heredado de Encoding)

Métodos

Clone()	Cuando se reemplaza en una clase derivada, crea una copia superficial del objeto Encoding actual. (Heredado de Encoding)
Equals(Object)	Determina si el objeto Object especificado es igual a la instancia actual. (Heredado de Encoding)
GetByteCount(Char*, Int32)	Calcula el número de bytes generado mediante la codificación de un juego de caracteres a partir del puntero de caracteres especificado.
GetByteCount(Char[])	Cuando se reemplaza en una clase derivada, calcula el número de bytes que se generan al codificar todos los caracteres de la matriz de caracteres especificada. (Heredado de Encoding)
GetByteCount(Char[], Int32, Int32)	Calcula el número de bytes generado mediante la codificación de un juego de caracteres de la matriz de caracteres especificada.
GetByteCount(ReadOnlySpan<Char>)	Calcula el número de bytes generado al codificar el intervalo de caracteres especificado.
GetByteCount(String)	Calcula el número de bytes generado al codificar los caracteres del objeto String especificado.
GetByteCount(String, Int32, Int32)	Cuando se invalida en una clase derivada, calcula el número de bytes que se generan al codificar un juego de caracteres a partir de la cadena especificada. (Heredado de Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	Codifica un juego de caracteres a partir del puntero de caracteres especificado en una secuencia de bytes que se almacenan a partir del puntero de bytes especificado.
GetBytes(Char[])	Cuando se reemplaza en una clase derivada, codifica todos los caracteres de la matriz de caracteres especificada en una secuencia de bytes. (Heredado de Encoding)
GetBytes(Char[], Int32, Int32)	Cuando se reemplaza en una clase derivada, codifica un juego de caracteres de la matriz de caracteres especificada en una secuencia de bytes. (Heredado de Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Codifica un juego de caracteres de la matriz de caracteres determinada en la matriz de bytes especificada.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Codifica el intervalo de caracteres especificado en el intervalo de bytes especificado.
GetBytes(String)	Cuando se reemplaza en una clase derivada, codifica todos los caracteres de la cadena especificada en una secuencia de bytes. (Heredado de Encoding)
GetBytes(String, Int32, Int32)	Cuando se invalida en una clase derivada, codifica en una matriz de bytes el número de caracteres especificado por count en la cadena especificada, empezando por el elemento index especificado. (Heredado de Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Codifica un juego de caracteres del objeto String especificado en la matriz de bytes especificada.
GetCharCount(Byte*, Int32)	Calcula el número de caracteres generado mediante la descodificación de una secuencia de bytes a partir del puntero de bytes especificado.
GetCharCount(Byte[])	Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar todos los bytes de la matriz de bytes especificada. (Heredado de Encoding)
GetCharCount(Byte[], Int32, Int32)	Calcula el número de caracteres generado mediante la descodificación de una secuencia de bytes a partir de la matriz de bytes especificada.
GetCharCount(ReadOnlySpan<Byte>)	Calcula el número de caracteres generado al descodificar el intervalo de bytes especificado.
GetChars(Byte*, Int32, Char*, Int32)	Descodifica una secuencia de bytes a partir del puntero de bytes especificado en un juego de caracteres que se almacenan a partir del puntero de caracteres especificado.
GetChars(Byte[])	Cuando se reemplaza en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en un juego de caracteres. (Heredado de Encoding)
GetChars(Byte[], Int32, Int32)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada en un juego de caracteres. (Heredado de Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Descodifica una secuencia de bytes de la matriz de bytes especificada en la matriz de caracteres especificada.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Descodifica el intervalo de bytes especificado en el intervalo de caracteres especificado.
GetDecoder()	Obtiene un descodificador que convierte una secuencia de bytes codificada en ASCII en una secuencia de caracteres Unicode.
GetEncoder()	Obtiene un codificador que convierte una secuencia de caracteres Unicode en una secuencia de bytes codificada en ASCII.
GetHashCode()	Devuelve el código hash de la instancia actual. (Heredado de Encoding)
GetMaxByteCount(Int32)	Calcula el número máximo de bytes generado mediante la codificación del número de caracteres especificado.
GetMaxCharCount(Int32)	Calcula el número máximo de caracteres generado mediante la descodificación del número de bytes especificado.
GetPreamble()	Cuando se reemplaza en una clase derivada, devuelve una secuencia de bytes que especifica la codificación utilizada. (Heredado de Encoding)
GetString(Byte*, Int32)	Cuando se reemplaza en una clase derivada, descodifica un número determinado de bytes a partir de una dirección especificada en una cadena. (Heredado de Encoding)
GetString(Byte[])	Cuando se reemplaza en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en una cadena. (Heredado de Encoding)
GetString(Byte[], Int32, Int32)	Descodifica un intervalo de bytes de una matriz de bytes en una cadena.
GetString(ReadOnlySpan<Byte>)	Cuando se invalida en una clase derivada, descodifica todos los bytes del intervalo de bytes especificado en una cadena. (Heredado de Encoding)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsAlwaysNormalized()	Obtiene un valor que indica si la codificación actual siempre se normaliza, utilizando la forma de normalización predeterminada. (Heredado de Encoding)
IsAlwaysNormalized(NormalizationForm)	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual siempre se normaliza mediante la forma de normalización especificada. (Heredado de Encoding)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Codifica en un intervalo de bytes un conjunto de caracteres del intervalo de solo lectura especificado si el destino es lo suficientemente grande.
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Descodifica en un intervalo de caracteres un conjunto de bytes del intervalo de solo lectura especificado si el destino es lo suficientemente grande.

Métodos de extensión

GetBytes(Encoding, ReadOnlySequence<Char>)	Codifica el elemento ReadOnlySequence<T> especificado en una matriz Byte mediante el elemento Encoding especificado.
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Descodifica el elemento ReadOnlySequence<T> especificado en bytes mediante el elemento Encoding especificado y escribe el resultado en writer.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Codifica el elemento ReadOnlySequence<T> especificado en bytes mediante el elemento Encoding especificado y envía el resultado a bytes.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Codifica el elemento ReadOnlySpan<T> especificado en bytes mediante el elemento Encoding especificado y escribe el resultado en writer.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Descodifica el elemento ReadOnlySequence<T> especificado en chars mediante el elemento Encoding especificado y escribe el resultado en writer.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Descodifica el elemento ReadOnlySequence<T> especificado en chars mediante el elemento Encoding especificado y envía el resultado a chars.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Descodifica el elemento ReadOnlySpan<T> especificado en chars mediante el elemento Encoding especificado y escribe el resultado en writer.
GetString(Encoding, ReadOnlySequence<Byte>)	Descodifica el elemento ReadOnlySequence<T> especificado en String mediante el elemento Encoding especificado.

Consulte también

• Decoder
• Encoder
• Descripción de las codificaciones