System.Text Namespace

El espacio de nombres System.Text contiene clases que representan codificaciones de caracteres ASCII y Unicode; clases base abstractas para convertir bloques de caracteres a y desde bloques de bytes y una clase auxiliar que manipula y da formato a objetos String sin crear instancias intermedias de String. The System.Text namespace contains classes that represent ASCII and Unicode character encodings; abstract base classes for converting blocks of characters to and from blocks of bytes; and a helper class that manipulates and formats String objects without creating intermediate instances of String.

Clases

ASCIIEncoding

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

CodePagesEncodingProvider

Proporciona acceso a un proveedor de codificación para páginas de código admitidas en .NET Framework de escritorio pero no en aplicaciones UWP.Provides access to an encoding provider for code pages supported in the desktop .NET Framework but not in UWP apps.

Decoder

Convierte una secuencia de bytes codificados en un juego de caracteres.Converts a sequence of encoded bytes into a set of characters.

DecoderExceptionFallback

Proporciona un mecanismo de control de errores, denominado reserva, relativo a una secuencia codificada de bytes de entrada que no se puede convertir en un carácter de entrada.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an input character. La reserva produce una excepción en lugar de descodificar la secuencia de bytes de entrada.The fallback throws an exception instead of decoding the input byte sequence. Esta clase no puede heredarse.This class cannot be inherited.

DecoderExceptionFallbackBuffer

Produce una excepción DecoderFallbackException cuando una secuencia de bytes de entrada codificada no se puede convertir en un carácter de salida descodificado.Throws DecoderFallbackException when an encoded input byte sequence cannot be converted to a decoded output character. Esta clase no puede heredarse.This class cannot be inherited.

DecoderFallback

Proporciona un mecanismo de control de errores, denominado reserva, para una secuencia codificada de bytes de entrada que no se puede convertir en un carácter de salida.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character.

DecoderFallbackBuffer

Proporciona un búfer que permite a un controlador de retroceso devolver una cadena alternativa a un descodificador cuando no puede descodificar una secuencia de bytes de entrada.Provides a buffer that allows a fallback handler to return an alternate string to a decoder when it cannot decode an input byte sequence.

DecoderFallbackException

Excepción que se produce cuando una operación de retroceso del descodificador (decoder fallback) no se realiza correctamente.The exception that is thrown when a decoder fallback operation fails. Esta clase no puede heredarse.This class cannot be inherited.

DecoderReplacementFallback

Proporciona un mecanismo de control de errores, denominado reserva, para una secuencia codificada de bytes de entrada que no se puede convertir en un carácter de salida.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character. La reserva emite una cadena de reemplazo especificada por el usuario en lugar de una secuencia descodificada de bytes de entrada.The fallback emits a user-specified replacement string instead of a decoded input byte sequence. Esta clase no puede heredarse.This class cannot be inherited.

DecoderReplacementFallbackBuffer

Representa una cadena de salida suplente que se emite cuando no se puede descodificar la secuencia de bytes de entrada original.Represents a substitute output string that is emitted when the original input byte sequence cannot be decoded. Esta clase no puede heredarse.This class cannot be inherited.

Encoder

Codifica un juego de caracteres en una secuencia de bytes.Converts a set of characters into a sequence of bytes.

EncoderExceptionFallback

Proporciona un mecanismo de control de errores, denominado reserva, aplicable a un carácter de entrada que no se puede convertir en una secuencia de bytes de salida.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. La reserva produce una excepción si un carácter de entrada no se puede convertir en una secuencia de bytes de salida.The fallback throws an exception if an input character cannot be converted to an output byte sequence. Esta clase no puede heredarse.This class cannot be inherited.

EncoderExceptionFallbackBuffer

Produce una excepción EncoderFallbackException cuando un carácter de entrada no se puede convertir en una secuencia de bytes de salida codificada.Throws EncoderFallbackException when an input character cannot be converted to an encoded output byte sequence. Esta clase no puede heredarse.This class cannot be inherited.

EncoderFallback

Proporciona un mecanismo de control de errores, denominado reserva, para un carácter de entrada que no puede convertirse en una secuencia codificada de bytes de salida.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an encoded output byte sequence.

EncoderFallbackBuffer

Proporciona un búfer que permite a un controlador de retroceso devolver una cadena alternativa a un codificador cuando no puede codificar un carácter de entrada.Provides a buffer that allows a fallback handler to return an alternate string to an encoder when it cannot encode an input character.

EncoderFallbackException

La excepción que se produce cuando se produce un error en la operación de reserva de codificador.The exception that is thrown when an encoder fallback operation fails. Esta clase no puede heredarse.This class cannot be inherited.

EncoderReplacementFallback

Proporciona un mecanismo de control de errores, denominado reserva, para un carácter de entrada que no se puede convertir en una secuencia de bytes de salida.Provides a failure handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. El recurso de reserva usa una cadena de reemplazo especificada por el usuario en lugar del carácter de entrada original.The fallback uses a user-specified replacement string instead of the original input character. Esta clase no puede heredarse.This class cannot be inherited.

EncoderReplacementFallbackBuffer

Representa una cadena de entrada suplente que se utiliza cuando no se puede codificar el carácter de entrada original.Represents a substitute input string that is used when the original input character cannot be encoded. Esta clase no puede heredarse.This class cannot be inherited.

Encoding

Representa una codificación de caracteres.Represents a character encoding.

EncodingInfo

Proporciona la información básica sobre una codificación.Provides basic information about an encoding.

EncodingProvider

Proporciona la clase base de un proveedor de codificación, que suministra las codificaciones que no están disponibles en una plataforma concreta.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

StringBuilder

Representa una cadena de caracteres mutable.Represents a mutable string of characters. Esta clase no puede heredarse.This class cannot be inherited.

UnicodeEncoding

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

UTF32Encoding

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

UTF7Encoding

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

UTF8Encoding

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

Estructuras

Rune
SpanRuneEnumerator
StringBuilder.ChunkEnumerator
StringRuneEnumerator

Enumeraciones

NormalizationForm

Define el tipo de normalización a realizar.Defines the type of normalization to perform.

Comentarios

Las clases de codificación están pensadas principalmente para convertir entre codificaciones diferentes o las páginas de códigos y una codificación Unicode.The encoding classes are primarily intended to convert between different encodings or code pages and a Unicode encoding. Encoding.Unicode Codificación (UTF-16) se usa internamente por .NET Framework, y Encoding.UTF8 codificación a menudo se usa para almacenar datos de caracteres para garantizar la portabilidad en los equipos y las referencias culturales.Encoding.Unicode (UTF-16) encoding is used internally by the .NET Framework, and Encoding.UTF8 encoding is often used for storing character data to ensure portability across machines and cultures.

Las clases derivadas de Encoding le permiten elegir una estrategia de reserva, que determina cómo se controlan los caracteres que no se puede codificar en una secuencia de bytes o bytes que no se puede descodificar en caracteres.The classes derived from Encoding enable you to choose a fallback strategy, which determines how characters that cannot be encoded into a sequence of bytes, or bytes that cannot be decoded into characters, are handled. Puede elegir uno de los siguientes:You can choose one of the following:

  • Reserva de excepción.Exception fallback. Puede elegir que se produzcan excepciones en errores de datos mediante un throwonerror marca que está disponible en algunos constructores de clase o mediante el EncoderExceptionFallback y DecoderExceptionFallback clases.You can choose to throw exceptions on data errors either by using a throwonerror flag that is available in some class constructors or by using the EncoderExceptionFallback and DecoderExceptionFallback classes. Si le preocupa la integridad del flujo de datos, se recomienda la produce una excepción.If you are concerned about the integrity of the data stream, throwing on an exception is recommended.

  • Reserva de reemplazo.Replacement fallback. Puede usar el EncoderFallback y DecoderFallback clases cambien silenciosamente un carácter "?" o el carácter de reemplazo Unicode (U+FFFD).You can use the EncoderFallback and DecoderFallback classes to silently change a character to "?" or to the Unicode replacement character (U+FFFD).

  • Reserva con ajuste perfecto.Best-fit fallback. Esta opción asigna un carácter en una codificación a un carácter en otra codificación.This option maps a character in one encoding to a character in another encoding. Retroceso de ajuste perfecto a menudo no se recomienda porque puede provocar pérdida de datos y la confusión y es más lento que un simple "?" reemplazos de caracteres.Best fit fallback is often not recommended because it can cause data loss and confusion, and is slower than simple "?" character replacements. Sin embargo, para páginas de códigos ANSI el comportamiento de ajuste perfecto es el valor predeterminado.However, for ANSI code pages the best-fit behavior is the default.

La StringBuilder clase está diseñada para las operaciones que realizan manipulaciones extensas en una sola cadena.The StringBuilder class is designed for operations that perform extensive manipulations on a single string. A diferencia de la String (clase), el StringBuilder clase es mutable y proporciona un mejor rendimiento al concatenar o eliminar las cadenas.Unlike the String class, the StringBuilder class is mutable and provides better performance when concatenating or deleting strings.

Para obtener más información acerca de System.Text, consulte codificación de caracteres en .NET Framework .For more information about System.Text, see Character Encoding in the .NET Framework .