UnicodeEncoding UnicodeEncoding UnicodeEncoding UnicodeEncoding Class

Definición

Representa una codificación UTF-16 de caracteres Unicode.Represents a UTF-16 encoding of Unicode characters.

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

Ejemplos

En el ejemplo siguiente se muestra cómo codificar una cadena de caracteres Unicode en una matriz de bytes mediante el uso de un UnicodeEncoding objeto.The following example demonstrates how to encode a string of Unicode characters into a byte array by using a UnicodeEncoding object. La matriz de bytes se descodifica en una cadena para demostrar que no hay ninguna pérdida de datos.The byte array is decoded into a string to demonstrate that there is no loss of data.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   
   // The encoding.
   UnicodeEncoding^ unicode = gcnew UnicodeEncoding;
   
   // Create a String* that contains Unicode characters.
   String^ unicodeString = L"This Unicode string contains two characters with codes outside the traditional ASCII code range, Pi (\u03a0) and Sigma (\u03a3).";
   Console::WriteLine( "Original string:" );
   Console::WriteLine( unicodeString );
   
   // Encode the String*.
   array<Byte>^encodedBytes = unicode->GetBytes( unicodeString );
   Console::WriteLine();
   Console::WriteLine( "Encoded bytes:" );
   IEnumerator^ myEnum = encodedBytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
   
   // Decode bytes back to String*.
   // Notice Pi and Sigma characters are still present.
   String^ decodedString = unicode->GetString( encodedBytes );
   Console::WriteLine();
   Console::WriteLine( "Decoded bytes:" );
   Console::WriteLine( decodedString );
}

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        // The encoding.
        UnicodeEncoding unicode = new UnicodeEncoding();
        
        // Create a string that contains Unicode characters.
        String unicodeString =
            "This Unicode string contains two characters " +
            "with codes outside the traditional ASCII code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = unicode.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
        
        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = unicode.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}
Imports System
Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        ' The encoding.
        Dim uni As New UnicodeEncoding()
        
        ' Create a string that contains Unicode characters.
        Dim unicodeString As String = _
            "This Unicode string contains two characters " & _
            "with codes outside the traditional ASCII code range, " & _
            "Pi (" & ChrW(928) & ") and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        
        ' Encode the string.
        Dim encodedBytes As Byte() = uni.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()
        
        ' Decode bytes back to string.
        ' Notice Pi and Sigma characters are still present.
        Dim decodedString As String = uni.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class

En el ejemplo siguiente se usa la misma cadena que el anterior, excepto en que escribe los bytes codificados en un archivo y prefijos de la secuencia de bytes con una marca de orden de bytes (BOM).The following example uses the same string as the previous one, except that it writes the encoded bytes to a file and prefixes the byte stream with a byte order mark (BOM). A continuación, lee el archivo de dos maneras diferentes: como un archivo de texto mediante el uso de un StreamReader objeto; y como un archivo binario.It then reads the file in two different ways: as a text file by using a StreamReader object; and as a binary file. Como cabría esperar, ninguna cadena recién lectura incluye la marca BOM.As you would expect, neither newly-read string includes the BOM.

using System;
using System.IO;
using System.Text;

public class Example
{
   public static void Main()
   {
        // Create a UTF-16 encoding that supports a BOM.
        Encoding unicode = new UnicodeEncoding();

        // A Unicode string with two characters outside an 8-bit code range.
        String unicodeString =
            "This Unicode string has 2 characters outside the " +
            "ASCII range: \n" +
            "Pi (\u03A0)), and Sigma (\u03A3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);
        Console.WriteLine();

        // Encode the string.
        Byte[] encodedBytes = unicode.GetBytes(unicodeString);
        Console.WriteLine("The encoded string has {0} bytes.\n",
                          encodedBytes.Length);

        // Write the bytes to a file with a BOM.
        var fs = new FileStream(@".\UTF8Encoding.txt", FileMode.Create);
        Byte[] bom = unicode.GetPreamble();
        fs.Write(bom, 0, bom.Length);
        fs.Write(encodedBytes, 0, encodedBytes.Length);
        Console.WriteLine("Wrote {0} bytes to the file.\n", fs.Length);
        fs.Close();

        // Open the file using StreamReader.
        var sr = new StreamReader(@".\UTF8Encoding.txt");
        String newString = sr.ReadToEnd();
        sr.Close();
        Console.WriteLine("String read using StreamReader:");
        Console.WriteLine(newString);
        Console.WriteLine();

        // Open the file as a binary file and decode the bytes back to a string.
        fs = new FileStream(@".\UTF8Encoding.txt", FileMode.Open);
        Byte[] bytes = new Byte[fs.Length];
        fs.Read(bytes, 0, (int)fs.Length);
        fs.Close();

        String decodedString = unicode.GetString(bytes);
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
   }
}
// The example displays the following output:
//    Original string:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    The encoded string has 172 bytes.
//
//    Wrote 174 bytes to the file.
//
//    String read using StreamReader:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
//
//    Decoded bytes:
//    This Unicode string has 2 characters outside the ASCII range:
//    Pi (π), and Sigma (Σ).
Imports System.IO
Imports System.Text

Class Example
    Public Shared Sub Main()
        ' Create a UTF-16 encoding that supports a BOM.
        Dim unicode As New UnicodeEncoding()
        
        ' A Unicode string with two characters outside an 8-bit code range.
        Dim unicodeString As String = _
            "This Unicode string has 2 characters outside the " &
            "ASCII range: " & vbCrLf &
            "Pi (" & ChrW(&h03A0) & "), and Sigma (" & ChrW(&h03A3) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        Console.WriteLine()
        
        ' Encode the string.
        Dim encodedBytes As Byte() = unicode.GetBytes(unicodeString)
        Console.WriteLine("The encoded string has {0} bytes.",
                          encodedBytes.Length)
        Console.WriteLine()
        
        ' Write the bytes to a file with a BOM.
        Dim fs As New FileStream(".\UnicodeEncoding.txt", FileMode.Create)
        Dim bom() As Byte = unicode.GetPreamble()
        fs.Write(bom, 0, bom.Length)
        fs.Write(encodedBytes, 0, encodedBytes.Length)
        Console.WriteLine("Wrote {0} bytes to the file.", fs.Length)
        fs.Close()
        Console.WriteLine()
        
        ' Open the file using StreamReader.
        Dim sr As New StreamReader(".\UnicodeEncoding.txt")
        Dim newString As String = sr.ReadToEnd()
        sr.Close()
        Console.WriteLine("String read using StreamReader:")
        Console.WriteLine(newString)
        Console.WriteLine()
        
        ' Open the file as a binary file and decode the bytes back to a string.
        fs = new FileStream(".\UnicodeEncoding.txt", FileMode.Open)
        Dim bytes(fs.Length - 1) As Byte
        fs.Read(bytes, 0, fs.Length)
        fs.Close()

        Dim decodedString As String = unicode.GetString(bytes)
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class
' The example displays the following output:
'    Original string:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).
'
'    The encoded string has 172 bytes.
'
'    Wrote 174 bytes to the file.
'
'    String read using StreamReader:
'    This Unicode string has 2 characters outside the ASCII range:
'    Pi (π), and Sigma (Σ).
'
'    Decoded bytes:
'    This Unicode string has 2 characters outside the ASCII range:
'    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.

El estándar Unicode asigna un punto de código (un número) a cada carácter en todos los scripts admitidos.The Unicode Standard assigns a code point (a number) to each character in every supported script. Un formato de transformación Unicode (UTF) es una manera de codificar ese punto de código.A Unicode Transformation Format (UTF) is a way to encode that code point. El estándar Unicode usa las siguientes codificaciones UTF:The Unicode Standard uses the following UTFs:

  • UTF-8, que representa cada punto de código como una secuencia de uno a cuatro bytes.UTF-8, which represents each code point as a sequence of one to four bytes.

  • UTF-16, que representa cada punto de código como una secuencia de uno o dos enteros de 16 bits.UTF-16, which represents each code point as a sequence of one to two 16-bit integers.

  • UTF-32, que representa cada punto de código como un entero de 32 bits.UTF-32, which represents each code point as a 32-bit integer.

Para obtener más información acerca de las codificaciones UTF y otras codificaciones admitidas por System.Text, consulte codificación de caracteres en .NET Framework.For more information about the UTFs and other encodings supported by System.Text, see Character Encoding in the .NET Framework.

La UnicodeEncoding clase representa una codificación UTF-16.The UnicodeEncoding class represents a UTF-16 encoding. El codificador puede usar en cualquier orden de bytes big endian (byte más significativo primero) o el orden de bytes endian little (byte menos significativo primero).The encoder can use either big endian byte order (most significant byte first) or little endian byte order (least significant byte first). Por ejemplo, la letra mayúscula latina (punto de código u+0041) se serializa como sigue (en hexadecimal):For example, the Latin Capital Letter A (code point U+0041) is serialized as follows (in hexadecimal):

  • Orden de bytes big endian: 00 00 00 41Big endian byte order: 00 00 00 41

  • Orden de bytes endian little: 41 00 00 00Little endian byte order: 41 00 00 00

Es normalmente más eficaz para almacenar caracteres Unicode mediante el orden de bytes nativo de una plataforma concreta.It is generally more efficient to store Unicode characters using the native byte order of a particular platform. Por ejemplo, es mejor utilizar el orden de bytes endian little en plataformas little-endian, como equipos Intel.For example, it is better to use the little endian byte order on little endian platforms, such as Intel computers. La UnicodeEncoding clase corresponde a las páginas de códigos 1200 (orden de bytes endian little) y 1201 (orden de bytes big endian) de Windows.The UnicodeEncoding class corresponds to the Windows code pages 1200 (little endian byte order) and 1201 (big endian byte order). Puede determinar los "modos endian" de una arquitectura concreta mediante una llamada a la BitConverter.IsLittleEndian método.You can determine the "endianness" of a particular architecture by calling the BitConverter.IsLittleEndian method.

Opcionalmente, el UnicodeEncoding objeto proporciona una marca de orden de bytes (BOM), que es una matriz de bytes que se puede anteponer a la secuencia de bytes resultante del proceso de codificación.Optionally, the UnicodeEncoding object provides a byte order mark (BOM), which is an array of bytes that can be prefixed to the sequence of bytes resulting from the encoding process. Si el preámbulo contiene una marca de orden de bytes (BOM), ayudará al descodificador a determinar el orden de bytes y el formato de transformación o UTF.If the preamble contains a byte order mark (BOM), it helps the decoder determine the byte order and the transformation format or UTF.

Si el UnicodeEncoding instancia está configurada para proporcionar una lista de materiales, puede recuperarlo mediante una llamada a la GetPreamble método; en caso contrario, el método devuelve una matriz vacía.If the UnicodeEncoding instance is configured to provide a BOM, you can retrieve it by calling the GetPreamble method; otherwise, the method returns an empty array. Tenga en cuenta que, incluso si un UnicodeEncoding objeto está configurado para admitir l. MAT, debe incluir la marca BOM al principio de la secuencia de bytes codificada según corresponda; los métodos de codificación de la UnicodeEncoding clase no lo hace automáticamente.Note that, even if a UnicodeEncoding object is configured for BOM support, you must include the BOM at the beginning of the encoded byte stream as appropriate; the encoding methods of the UnicodeEncoding class do not do this automatically.

Precaución

Para habilitar la detección de errores y hacer que la instancia de clase sea más segura, debe crear una instancia un UnicodeEncoding objeto mediante una llamada a la UnicodeEncoding(Boolean, Boolean, Boolean) constructor y estableciendo su throwOnInvalidBytes argumento true.To enable error detection and to make the class instance more secure, you should instantiate a UnicodeEncoding object by calling the UnicodeEncoding(Boolean, Boolean, Boolean) constructor and setting its throwOnInvalidBytes argument to true. Con la detección de errores, un método que detecta una secuencia de caracteres o bytes no válida inicia una ArgumentException.With error detection, a method that detects an invalid sequence of characters or bytes throws a ArgumentException. Sin detección de errores, se produce ninguna excepción y, por lo general se omite la secuencia no válida.Without error detection, no exception is thrown, and the invalid sequence is generally ignored.

Puede crear instancias de un UnicodeEncoding objetos de varias maneras, dependiendo de si desea que se proporciona una marca de orden de bytes (BOM), si desea que la codificación big endian o little-endian y si desea habilitar la detección de errores.You can instantiate a UnicodeEncoding object in a number of ways, depending on whether you want to it to provide a byte order mark (BOM), whether you want big-endian or little-endian encoding, and whether you want to enable error detection. La siguiente tabla se enumeran los UnicodeEncoding constructores y el Encoding propiedades que devuelven un UnicodeEncoding objeto.The following table lists the UnicodeEncoding constructors and the Encoding properties that return a UnicodeEncoding object.

MiembroMember Modos endianEndianness BOMBOM Detección de erroresError detection
BigEndianUnicode Big-endianBig-endian Yes Ninguna (reserva de reemplazo)No (Replacement fallback)
Encoding.Unicode Little-endianLittle-endian Yes Ninguna (reserva de reemplazo)No (Replacement fallback)
UnicodeEncoding.UnicodeEncoding() Little-endianLittle-endian Yes Ninguna (reserva de reemplazo)No (Replacement fallback)
UnicodeEncoding(Boolean, Boolean) ConfigurableConfigurable ConfigurableConfigurable Ninguna (reserva de reemplazo)No (Replacement fallback)
UnicodeEncoding.UnicodeEncoding(Boolean, Boolean, Boolean) ConfigurableConfigurable ConfigurableConfigurable ConfigurableConfigurable

El GetByteCount método determina el número de bytes resultante de codificar un juego 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 resultante de descodificar una secuencia de bytes y el GetChars y GetString métodos 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.

Para un codificador o descodificador que es capaz de guardar información de estado al codificar o descodificar los datos que abarca varios bloques (por ejemplo, la cadena de 1 millón de caracteres que se codifica en segmentos de 100 000 caracteres), use el GetEncoder y GetDecoder propiedades, respectivamente.For an encoder or decoder that is able to save state information when encoding or decoding data that spans multiple blocks (such as string of 1 million characters that is encoded in 100,000-character segments), use the GetEncoder and GetDecoder properties, respectively.

Constructores

UnicodeEncoding() UnicodeEncoding() UnicodeEncoding() UnicodeEncoding()

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

UnicodeEncoding(Boolean, Boolean) UnicodeEncoding(Boolean, Boolean) UnicodeEncoding(Boolean, Boolean) UnicodeEncoding(Boolean, Boolean)

Inicializa una nueva instancia de la clase UnicodeEncoding.Initializes a new instance of the UnicodeEncoding class. Los parámetros especifican si se usa el orden de bytes big endian y si el método GetPreamble() devuelve una marca de orden de bytes Unicode.Parameters specify whether to use the big endian byte order and whether the GetPreamble() method returns a Unicode byte order mark.

UnicodeEncoding(Boolean, Boolean, Boolean) UnicodeEncoding(Boolean, Boolean, Boolean) UnicodeEncoding(Boolean, Boolean, Boolean) UnicodeEncoding(Boolean, Boolean, Boolean)

Inicializa una nueva instancia de la clase UnicodeEncoding.Initializes a new instance of the UnicodeEncoding class. Los parámetros especifican si se usa el orden de bytes big endian, si se proporciona una marca de orden de bytes Unicode y si se produce una excepción cuando se detecta una codificación no válida.Parameters specify whether to use the big endian byte order, whether to provide a Unicode byte order mark, and whether to throw an exception when an invalid encoding is detected.

Campos

CharSize CharSize CharSize CharSize

Representa, en bytes, el tamaño de caracteres Unicode.Represents the Unicode character size in bytes. Este campo es una constante.This field is a constant.

Métodos

Clone() Clone() Clone() 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.

(Inherited from Encoding)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto Object especificado es igual al objeto UnicodeEncoding actual.Determines whether the specified Object is equal to the current UnicodeEncoding object.

GetByteCount(Char*, Int32) GetByteCount(Char*, Int32) GetByteCount(Char*, Int32) 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[]) GetByteCount(Char[]) GetByteCount(Char[]) 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.

(Inherited from Encoding)
GetByteCount(Char[], Int32, Int32) GetByteCount(Char[], Int32, Int32) GetByteCount(Char[], Int32, Int32) 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>) GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>) Inherited from Encoding
GetByteCount(String) GetByteCount(String) GetByteCount(String) GetByteCount(String)

Calcula el número de bytes generado al codificar los caracteres de la cadena especificada.Calculates the number of bytes produced by encoding the characters in the specified string.

GetByteCount(String, Int32, Int32) GetByteCount(String, Int32, Int32) GetByteCount(String, Int32, Int32) GetByteCount(String, Int32, Int32) Inherited from Encoding
GetBytes(Char*, Int32, Byte*, Int32) GetBytes(Char*, Int32, Byte*, Int32) GetBytes(Char*, Int32, Byte*, Int32) 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[]) GetBytes(Char[]) GetBytes(Char[]) 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.

(Inherited from Encoding)
GetBytes(Char[], Int32, Int32) GetBytes(Char[], Int32, Int32) GetBytes(Char[], Int32, Int32) 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.

(Inherited from Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32) GetBytes(Char[], Int32, Int32, Byte[], Int32) GetBytes(Char[], Int32, Int32, Byte[], Int32) 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>) GetBytes(ReadOnlySpan<Char>, Span<Byte>) GetBytes(ReadOnlySpan<Char>, Span<Byte>) GetBytes(ReadOnlySpan<Char>, Span<Byte>) Inherited from Encoding
GetBytes(String) GetBytes(String) GetBytes(String) GetBytes(String)
GetBytes(String, Int32, Int32) GetBytes(String, Int32, Int32) GetBytes(String, Int32, Int32) GetBytes(String, Int32, Int32) Inherited from Encoding
GetBytes(String, Int32, Int32, Byte[], Int32) GetBytes(String, Int32, Int32, Byte[], Int32) GetBytes(String, Int32, Int32, Byte[], Int32) 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) GetCharCount(Byte*, Int32) GetCharCount(Byte*, Int32) 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[]) GetCharCount(Byte[]) GetCharCount(Byte[]) 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.

(Inherited from Encoding)
GetCharCount(Byte[], Int32, Int32) GetCharCount(Byte[], Int32, Int32) GetCharCount(Byte[], Int32, Int32) 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>) GetCharCount(ReadOnlySpan<Byte>) GetCharCount(ReadOnlySpan<Byte>) GetCharCount(ReadOnlySpan<Byte>) Inherited from Encoding
GetChars(Byte*, Int32, Char*, Int32) GetChars(Byte*, Int32, Char*, Int32) GetChars(Byte*, Int32, Char*, Int32) 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[]) GetChars(Byte[]) GetChars(Byte[]) 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.

(Inherited from Encoding)
GetChars(Byte[], Int32, Int32) GetChars(Byte[], Int32, Int32) GetChars(Byte[], Int32, Int32) 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.

(Inherited from Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32) GetChars(Byte[], Int32, Int32, Char[], Int32) GetChars(Byte[], Int32, Int32, Char[], Int32) 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>) GetChars(ReadOnlySpan<Byte>, Span<Char>) GetChars(ReadOnlySpan<Byte>, Span<Char>) GetChars(ReadOnlySpan<Byte>, Span<Char>) Inherited from Encoding
GetDecoder() GetDecoder() GetDecoder() GetDecoder()

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

GetEncoder() GetEncoder() GetEncoder() GetEncoder()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

GetMaxByteCount(Int32) GetMaxByteCount(Int32) GetMaxByteCount(Int32) 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) GetMaxCharCount(Int32) GetMaxCharCount(Int32) 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() GetPreamble() GetPreamble() GetPreamble()

Devuelve una marca de orden de bytes Unicode codificada en formato UTF-16 si el constructor empleado para esta instancia solicita una marca de orden de bytes.Returns a Unicode byte order mark encoded in UTF-16 format, if the constructor for this instance requests a byte order mark.

GetString(Byte*, Int32) GetString(Byte*, Int32) GetString(Byte*, Int32) 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.

(Inherited from Encoding)
GetString(Byte[]) GetString(Byte[]) 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.

(Inherited from Encoding)
GetString(Byte[], Int32, Int32) GetString(Byte[], Int32, Int32) GetString(Byte[], Int32, Int32) 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>) GetString(ReadOnlySpan<Byte>) GetString(ReadOnlySpan<Byte>) GetString(ReadOnlySpan<Byte>) Inherited from Encoding
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IsAlwaysNormalized() IsAlwaysNormalized() IsAlwaysNormalized() 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.

(Inherited from Encoding)
IsAlwaysNormalized(NormalizationForm) IsAlwaysNormalized(NormalizationForm) IsAlwaysNormalized(NormalizationForm) 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.

(Inherited from Encoding)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Propiedades

BodyName BodyName BodyName 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.

(Inherited from Encoding)
CodePage CodePage CodePage 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.

(Inherited from Encoding)
DecoderFallback DecoderFallback DecoderFallback DecoderFallback

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

(Inherited from Encoding)
EncoderFallback EncoderFallback EncoderFallback EncoderFallback

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

(Inherited from Encoding)
EncodingName EncodingName EncodingName 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.

(Inherited from Encoding)
HeaderName HeaderName HeaderName 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.

(Inherited from Encoding)
IsBrowserDisplay IsBrowserDisplay IsBrowserDisplay 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.

(Inherited from Encoding)
IsBrowserSave IsBrowserSave IsBrowserSave 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.

(Inherited from Encoding)
IsMailNewsDisplay IsMailNewsDisplay IsMailNewsDisplay 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.

(Inherited from Encoding)
IsMailNewsSave IsMailNewsSave IsMailNewsSave 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.

(Inherited from Encoding)
IsReadOnly IsReadOnly IsReadOnly 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.

(Inherited from Encoding)
IsSingleByte IsSingleByte IsSingleByte 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.

(Inherited from Encoding)
Preamble Preamble Preamble Preamble Inherited from Encoding
WebName WebName WebName 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.

(Inherited from Encoding)
WindowsCodePage WindowsCodePage WindowsCodePage 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.

(Inherited from Encoding)

Se aplica a

Consulte también: