ASCIIEncoding Clase

Definición

Representa una codificación de caracteres ASCII de caracteres Unicode.Represents an ASCII character encoding of Unicode characters.

public ref class ASCIIEncoding : System::Text::Encoding
public class ASCIIEncoding : System.Text.Encoding
[System.Serializable]
public class ASCIIEncoding : System.Text.Encoding
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ASCIIEncoding : System.Text.Encoding
type ASCIIEncoding = class
    inherit Encoding
[<System.Serializable>]
type ASCIIEncoding = class
    inherit Encoding
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ASCIIEncoding = class
    inherit Encoding
Public Class ASCIIEncoding
Inherits Encoding
Herencia
ASCIIEncoding
Atributos

Ejemplos

En el siguiente ejemplo se muestra cómo codificar caracteres Unicode en ASCII.The following example demonstrates how to encode Unicode characters into ASCII. Observe la pérdida de datos que se produce cuando la aplicación usa ASCIIEncoding para codificar caracteres Unicode fuera del intervalo ASCII.Notice the loss of data that occurs when your application uses ASCIIEncoding to encode Unicode characters outside of the ASCII range.

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.Encoding is the process of transforming a set of Unicode characters into a sequence of bytes. La descodificación es el proceso de transformar una secuencia de bytes codificados en un conjunto de caracteres Unicode.Decoding is the process of transforming a sequence of encoded bytes into a set of Unicode characters.

ASCIIEncoding corresponde a la página de códigos 20127 de Windows.ASCIIEncoding corresponds to the Windows code page 20127. Dado que ASCII es una codificación de 7 bits, los caracteres ASCII se limitan a los caracteres Unicode 128 más bajos, de U + 0000 a U + 007F.Because ASCII is a 7-bit encoding, ASCII characters are limited to the lowest 128 Unicode characters, from U+0000 to U+007F. Si utiliza el codificador predeterminado devuelto por la Encoding.ASCII propiedad o por el ASCIIEncoding constructor, los caracteres situados fuera de ese intervalo se reemplazan por un signo de interrogación (?) antes de que se realice la operación de codificación.If you use the default encoder returned by the Encoding.ASCII property or the ASCIIEncoding constructor, characters outside that range are replaced with a question mark (?) before the encoding operation is performed. Dado que la ASCIIEncoding clase solo admite un juego de caracteres limitado, las UTF8Encoding UnicodeEncoding clases, y UTF32Encoding son más adecuadas para las aplicaciones globalizadas.Because the ASCIIEncoding class supports only a limited character set, the UTF8Encoding, UnicodeEncoding, and UTF32Encoding classes are better suited for globalized applications. Las consideraciones siguientes pueden ayudarle a decidir si usar ASCIIEncoding :The following considerations can help you to decide whether to use ASCIIEncoding:

  • Algunos protocolos requieren ASCII o un subconjunto de ASCII.Some protocols require ASCII or a subset of ASCII. En estos casos, la codificación ASCII es adecuada.In these cases ASCII encoding is appropriate.

  • Si se espera una codificación de 8 bits, es probable que ASCII no sea la opción correcta.If an 8-bit encoding is expected, then ASCII probably isn't the correct choice. En su lugar, considere la posibilidad de usar UTF8 en lugar de ASCII.Instead, consider using UTF8 instead of ASCII. En el caso de 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.For the characters U+0000 through U+007F, the results are identical, but all Unicode characters are representable in UTF-8, which avoids data loss.

Precaución

ASCIIEncoding no proporciona detección de errores.ASCIIEncoding does not provide error detection. Por motivos de seguridad, debe usar UTF8Encoding , UnicodeEncoding o UTF32Encoding y habilitar la detección de errores.For security reasons, you should use UTF8Encoding, UnicodeEncoding, or UTF32Encoding and enable error detection.

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.The GetByteCount method determines how many bytes result in encoding a set of Unicode characters, and the GetBytes method performs the actual encoding.

Del mismo modo, el GetCharCount método determina el número de caracteres que tienen como resultado la descodificación de una secuencia de bytes y los GetChars GetString métodos y realizan la descodificación real.Likewise, the GetCharCount method determines how many characters result in decoding a sequence of bytes, and the GetChars and GetString methods perform the actual decoding.

Tenga en cuenta que el ASCIIEncoding constructor predeterminado por sí mismo podría no tener el comportamiento adecuado para su aplicación.Note that the default ASCIIEncoding constructor by itself might not have the appropriate behavior for your application. Puede que desee considerar la posibilidad de establecer la EncoderFallback DecoderFallback propiedad o en EncoderExceptionFallback o DecoderExceptionFallback para evitar secuencias con el conjunto de bits 8.You might want to consider setting the EncoderFallback or DecoderFallback property to EncoderExceptionFallback or DecoderExceptionFallback to prevent sequences with the 8th bit set. El comportamiento personalizado también puede ser adecuado para estos casos.Custom behavior might also be appropriate for these cases.

Constructores

ASCIIEncoding()

Inicializa una nueva instancia de la clase ASCIIEncoding.Initializes a new instance of the ASCIIEncoding class.

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.When overridden in a derived class, gets a name for the current encoding that can be used with mail agent body tags.

(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.When overridden in a derived class, gets the code page identifier of the current Encoding.

(Heredado de Encoding)
DecoderFallback

Obtiene o establece el objeto DecoderFallback para el objeto Encoding actual.Gets or sets the DecoderFallback object for the current Encoding object.

(Heredado de Encoding)
EncoderFallback

Obtiene o establece el objeto EncoderFallback para el objeto Encoding actual.Gets or sets the EncoderFallback object for the current Encoding object.

(Heredado de Encoding)
EncodingName

Cuando se reemplaza en una clase derivada, obtiene la descripción inteligible de la codificación actual.When overridden in a derived class, gets the human-readable description of the current encoding.

(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.When overridden in a derived class, gets a name for the current encoding that can be used with mail agent header tags.

(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.When overridden in a derived class, gets a value indicating whether the current encoding can be used by browser clients for displaying content.

(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.When overridden in a derived class, gets a value indicating whether the current encoding can be used by browser clients for saving content.

(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.When overridden in a derived class, gets a value indicating whether the current encoding can be used by mail and news clients for displaying content.

(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.When overridden in a derived class, gets a value indicating whether the current encoding can be used by mail and news clients for saving content.

(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.When overridden in a derived class, gets a value indicating whether the current encoding is read-only.

(Heredado de Encoding)
IsSingleByte

Obtiene un valor que indica si la codificación actual utiliza puntos de código de un solo byte.Gets a value indicating whether the current encoding uses single-byte code points.

IsSingleByte

Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual utiliza puntos de código de un solo byte.When overridden in a derived class, gets a value indicating whether the current encoding uses single-byte code points.

(Heredado de Encoding)
Preamble

Cuando se invalida en una clase derivada, devuelve un intervalo que contiene la secuencia de bytes que especifica la codificación utilizada.When overridden in a derived class, returns a span containing the sequence of bytes that specifies the encoding used.

(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.When overridden in a derived class, gets the name registered with the Internet Assigned Numbers Authority (IANA) for the current encoding.

(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.When overridden in a derived class, gets the Windows operating system code page that most closely corresponds to the current encoding.

(Heredado de Encoding)

Métodos

Clone()

Cuando se reemplaza en una clase derivada, crea una copia superficial del objeto Encoding actual.When overridden in a derived class, creates a shallow copy of the current Encoding object.

(Heredado de Encoding)
Equals(Object)

Determina si el objeto Object especificado es igual a la instancia actual.Determines whether the specified Object is equal to the current instance.

(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.Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

GetByteCount(Char*, Int32)

Cuando se reemplaza en una clase derivada, calcula el número de bytes que se generan al codificar un juego de caracteres a partir del puntero de caracteres especificado.When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

(Heredado de Encoding)
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.When overridden in a derived class, calculates the number of bytes produced by encoding all the characters in the specified character array.

(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.Calculates the number of bytes produced by encoding a set of characters from the specified character array.

GetByteCount(ReadOnlySpan<Char>)

Calcula el número de bytes generado al codificar el intervalo de caracteres especificado.Calculates the number of bytes produced by encoding the specified character span.

GetByteCount(ReadOnlySpan<Char>)

Cuando se invalida en una clase derivada, calcula el número de bytes que se generan al codificar los caracteres del intervalo de caracteres especificado.When overridden in a derived class, calculates the number of bytes produced by encoding the characters in the specified character span.

(Heredado de Encoding)
GetByteCount(String)

Calcula el número de bytes generado al codificar los caracteres del objeto String especificado.Calculates the number of bytes produced by encoding the characters in the specified String.

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.When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters from the specified string.

(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.Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.

GetBytes(Char*, Int32, Byte*, Int32)

Cuando se reemplaza en una clase derivada, 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.When overridden in a derived class, encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.

(Heredado de Encoding)
GetBytes(Char[])

Cuando se reemplaza en una clase derivada, codifica todos los caracteres de la matriz de caracteres especificada en una secuencia de bytes.When overridden in a derived class, encodes all the characters in the specified character array into a sequence of 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.When overridden in a derived class, encodes a set of characters from the specified character array into a sequence of 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.Encodes a set of characters from the specified character array into the specified byte array.

GetBytes(ReadOnlySpan<Char>, Span<Byte>)

Codifica el intervalo de caracteres especificado en el intervalo de bytes especificado.Encodes the specified character span into the specified byte span.

GetBytes(ReadOnlySpan<Char>, Span<Byte>)

Cuando se invalida en una clase derivada, codifica en un intervalo de bytes un juego de caracteres a partir del intervalo de solo lectura especificado.When overridden in a derived class, encodes into a span of bytes a set of characters from the specified read-only span.

(Heredado de Encoding)
GetBytes(String)

Cuando se reemplaza en una clase derivada, codifica todos los caracteres de la cadena especificada en una secuencia de bytes.When overridden in a derived class, encodes all the characters in the specified string into a sequence of 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.When overridden in a derived class, encodes into an array of bytes the number of characters specified by count in the specified string, starting from the specified index.

(Heredado de Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)

Codifica un juego de caracteres del objeto String especificado en la matriz de bytes especificada.Encodes a set of characters from the specified String into the specified byte array.

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.Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.

GetCharCount(Byte*, Int32)

Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes a partir del puntero de bytes especificado.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.

(Heredado de Encoding)
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.When overridden in a derived class, calculates the number of characters produced by decoding all the bytes in the specified byte array.

(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.Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.

GetCharCount(ReadOnlySpan<Byte>)

Calcula el número de caracteres generado al descodificar el intervalo de bytes especificado.Calculates the number of characters produced by decoding the specified byte span.

GetCharCount(ReadOnlySpan<Byte>)

Cuando se invalida en una clase derivada, calcula el número de caracteres que se generan al descodificar el intervalo de bytes de solo lectura proporcionado.When overridden in a derived class, calculates the number of characters produced by decoding the provided read-only byte span.

(Heredado de Encoding)
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.Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.

GetChars(Byte*, Int32, Char*, Int32)

Cuando se reemplaza en una clase derivada, 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.When overridden in a derived class, decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.

(Heredado de Encoding)
GetChars(Byte[])

Cuando se reemplaza en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en un juego de caracteres.When overridden in a derived class, decodes all the bytes in the specified byte array into a set of characters.

(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.When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a set of characters.

(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.Decodes a sequence of bytes from the specified byte array into the specified character array.

GetChars(ReadOnlySpan<Byte>, Span<Char>)

Descodifica el intervalo de bytes especificado en el intervalo de caracteres especificado.Decodes the specified byte span into the specified character span.

GetChars(ReadOnlySpan<Byte>, Span<Char>)

Cuando se invalida en una clase derivada, descodifica todos los bytes del intervalo de bytes de solo lectura especificado en un intervalo de caracteres.When overridden in a derived class, decodes all the bytes in the specified read-only byte span into a character span.

(Heredado de Encoding)
GetDecoder()

Obtiene un descodificador que convierte una secuencia de bytes codificada en ASCII en una secuencia de caracteres Unicode.Obtains a decoder that converts an ASCII encoded sequence of bytes into a sequence of Unicode characters.

GetDecoder()

Cuando se reemplaza en una clase derivada, obtiene un descodificador que convierte una secuencia de bytes codificada en una secuencia de caracteres.When overridden in a derived class, obtains a decoder that converts an encoded sequence of bytes into a sequence of characters.

(Heredado de Encoding)
GetEncoder()

Obtiene un codificador que convierte una secuencia de caracteres Unicode en una secuencia de bytes codificada en ASCII.Obtains an encoder that converts a sequence of Unicode characters into an ASCII encoded sequence of bytes.

GetEncoder()

Cuando se reemplaza en una clase derivada, obtiene un codificador que convierte una secuencia de caracteres Unicode en una secuencia de bytes codificada.When overridden in a derived class, obtains an encoder that converts a sequence of Unicode characters into an encoded sequence of bytes.

(Heredado de Encoding)
GetHashCode()

Devuelve el código hash de la instancia actual.Returns the hash code for the current instance.

(Heredado de Encoding)
GetMaxByteCount(Int32)

Calcula el número máximo de bytes generado mediante la codificación del número de caracteres especificado.Calculates the maximum number of bytes produced by encoding the specified number of characters.

GetMaxCharCount(Int32)

Calcula el número máximo de caracteres generado mediante la descodificación del número de bytes especificado.Calculates the maximum number of characters produced by decoding the specified number of bytes.

GetPreamble()

Cuando se reemplaza en una clase derivada, devuelve una secuencia de bytes que especifica la codificación utilizada.When overridden in a derived class, returns a sequence of bytes that specifies the encoding used.

(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.When overridden in a derived class, decodes a specified number of bytes starting at a specified address into a string.

(Heredado de Encoding)
GetString(Byte[])
GetString(Byte[])

Cuando se reemplaza en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en una cadena.When overridden in a derived class, decodes all the bytes in the specified byte array into a string.

(Heredado de Encoding)
GetString(Byte[], Int32, Int32)

Descodifica un intervalo de bytes de una matriz de bytes en una cadena.Decodes a range of bytes from a byte array into a string.

GetString(ReadOnlySpan<Byte>)

Cuando se invalida en una clase derivada, descodifica todos los bytes del intervalo de bytes especificado en una cadena.When overridden in a derived class, decodes all the bytes in the specified byte span into a string.

(Heredado de Encoding)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IsAlwaysNormalized()

Obtiene un valor que indica si la codificación actual siempre se normaliza, utilizando la forma de normalización predeterminada.Gets a value indicating whether the current encoding is always normalized, using the default normalization form.

(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.When overridden in a derived class, gets a value indicating whether the current encoding is always normalized, using the specified normalization form.

(Heredado de Encoding)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Métodos de extensión

GetBytes(Encoding, ReadOnlySequence<Char>)

Codifica el elemento ReadOnlySequence<T> especificado en una matriz Byte mediante el elemento Encoding especificado.Encodes the specified ReadOnlySequence<T> into a Byte array using the specified Encoding.

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.Decodes the specified ReadOnlySequence<T> to bytes using the specified Encoding and writes the result to 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.Encodes the specified ReadOnlySequence<T> to bytes using the specified Encoding and outputs the result to 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.Encodes the specified ReadOnlySpan<T> to bytes using the specified Encoding and writes the result to 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.Decodes the specified ReadOnlySequence<T> to chars using the specified Encoding and writes the result to 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.Decodes the specified ReadOnlySequence<T> to chars using the specified Encoding and outputs the result to 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.Decodes the specified ReadOnlySpan<T> to chars using the specified Encoding and writes the result to writer.

GetString(Encoding, ReadOnlySequence<Byte>)

Descodifica el elemento ReadOnlySequence<T> especificado en String mediante el elemento Encoding especificado.Decodes the specified ReadOnlySequence<T> into a String using the specified Encoding.

Se aplica a

Consulte también