System.Text Namespace

Lo spazio dei nomi System.Text contiene classi che rappresentano le codifiche dei caratteri ASCII e Unicode, classi base astratte per la conversione dei blocchi di caratteri in e da blocchi di byte e una classe helper che modifica e formatta gli oggetti String senza creare istanze intermedie di 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.

Classi

ASCIIEncoding

Rappresenta una codifica dei caratteri ASCII di caratteri Unicode.Represents an ASCII character encoding of Unicode characters.

CodePagesEncodingProvider

Fornisce l'accesso a un provider di codifica per le tabelle codici in caso contrario, sono disponibili solo nel desktop di .NET Framework.Provides access to an encoding provider for code pages that otherwise are available only in the desktop .NET Framework.

Decoder

Converte una sequenza di byte codificati in un set di caratteri.Converts a sequence of encoded bytes into a set of characters.

DecoderExceptionFallback

Offre un meccanismo di gestione degli errori, denominato fallback, per una sequenza di byte di input codificata che non può essere convertita in un carattere di input.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an input character. Il fallback genera un'eccezione anziché decodificare la sequenza di byte di input.The fallback throws an exception instead of decoding the input byte sequence. Questa classe non può essere ereditata.This class cannot be inherited.

DecoderExceptionFallbackBuffer

Genera un'eccezione DecoderFallbackException quando una sequenza di byte di input codificata non può essere convertita in un carattere di output decodificato.Throws DecoderFallbackException when an encoded input byte sequence cannot be converted to a decoded output character. Questa classe non può essere ereditata.This class cannot be inherited.

DecoderFallback

Fornisce un meccanismo di gestione degli errori, denominato fallback, per una sequenza di byte di input codificata che non può essere convertita in un carattere di output.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character.

DecoderFallbackBuffer

Fornisce un buffer che consente a un gestore di fallback di restituire una stringa alternativa a un decodificatore quando non può decodificare una sequenza di byte di input.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

Eccezione generata quando un'operazione di fallback del decodificatore non riesce.The exception that is thrown when a decoder fallback operation fails. Questa classe non può essere ereditata.This class cannot be inherited.

DecoderReplacementFallback

Fornisce un meccanismo di gestione degli errori, denominato fallback, per una sequenza di byte di input codificata che non può essere convertita in un carattere di output.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character. Tramite il fallback viene creata una stringa sostitutiva specificata dall'utente al posto di una sequenza di byte di input decodificata.The fallback emits a user-specified replacement string instead of a decoded input byte sequence. Questa classe non può essere ereditata.This class cannot be inherited.

DecoderReplacementFallbackBuffer

Rappresenta una stringa di output sostitutiva emessa quando la sequenza di byte di input originale non può essere decodificata.Represents a substitute output string that is emitted when the original input byte sequence cannot be decoded. Questa classe non può essere ereditata.This class cannot be inherited.

Encoder

Converte un set di caratteri in una sequenza di byte.Converts a set of characters into a sequence of bytes.

EncoderExceptionFallback

Offre un meccanismo di gestione degli errori, denominato fallback, per un carattere di input che non può essere convertito in una sequenza di byte di output.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. Il fallback genera un'eccezione se non è possibile convertire un carattere di input in una sequenza di byte di output.The fallback throws an exception if an input character cannot be converted to an output byte sequence. Questa classe non può essere ereditata.This class cannot be inherited.

EncoderExceptionFallbackBuffer

Genera un'eccezione EncoderFallbackException quando un carattere di input non può essere convertito in una sequenza di byte di output codificata.Throws EncoderFallbackException when an input character cannot be converted to an encoded output byte sequence. Questa classe non può essere ereditata.This class cannot be inherited.

EncoderFallback

Fornisce un meccanismo di gestione degli errori, denominato fallback, per un carattere di input che non può essere convertito in una sequenza di byte di output.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an encoded output byte sequence.

EncoderFallbackBuffer

Fornisce un buffer che consente a un gestore di fallback di restituire una stringa alternativa a un codificatore quando non può codificare un carattere di input.Provides a buffer that allows a fallback handler to return an alternate string to an encoder when it cannot encode an input character.

EncoderFallbackException

Eccezione generata quando l'operazione di fallback del codificatore non riesce.The exception that is thrown when an encoder fallback operation fails. Questa classe non può essere ereditata.This class cannot be inherited.

EncoderReplacementFallback

Fornisce un meccanismo di gestione degli errori, denominato fallback, per un carattere di input che non può essere convertito in una sequenza di byte di output.Provides a failure handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. Il fallback utilizza una stringa di sostituzione specificata dall'utente anziché il carattere di input originale.The fallback uses a user-specified replacement string instead of the original input character. Questa classe non può essere ereditata.This class cannot be inherited.

EncoderReplacementFallbackBuffer

Rappresenta una stringa di input sostitutiva utilizzata quando il carattere di input originale non può essere codificato.Represents a substitute input string that is used when the original input character cannot be encoded. Questa classe non può essere ereditata.This class cannot be inherited.

Encoding

Rappresenta una codifica caratteri.Represents a character encoding.

EncodingInfo

Fornisce informazioni di base su una codifica.Provides basic information about an encoding.

EncodingProvider

Fornisce la classe base per un provider di codifica, che fornisce le codifiche non disponibili in una particolare piattaforma.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

StringBuilder

Rappresenta una stringa modificabile di caratteri.Represents a mutable string of characters. Questa classe non può essere ereditata.This class cannot be inherited.

UnicodeEncoding

Rappresenta una codifica UTF-16 dei caratteri Unicode.Represents a UTF-16 encoding of Unicode characters.

UTF32Encoding

Rappresenta una codifica UTF-32 dei caratteri Unicode.Represents a UTF-32 encoding of Unicode characters.

UTF7Encoding

Rappresenta una codifica UTF-7 dei caratteri Unicode.Represents a UTF-7 encoding of Unicode characters.

UTF8Encoding

Rappresenta una codifica UTF-8 dei caratteri Unicode.Represents a UTF-8 encoding of Unicode characters.

Struct

Rune
SpanRuneEnumerator
StringBuilder.ChunkEnumerator
StringRuneEnumerator

Enumerazioni

NormalizationForm

Definisce il tipo di normalizzazione da eseguire.Defines the type of normalization to perform.

Commenti

Le classi di codifica sono principalmente per la conversione tra codifiche diverse o tabelle codici e una codifica Unicode.The encoding classes are primarily intended to convert between different encodings or code pages and a Unicode encoding. Encoding.Unicode Codifica (UTF-16) viene usata internamente da .NET Framework, e Encoding.UTF8 codifica viene spesso usata per l'archiviazione dei dati di tipo carattere per garantire la portabilità tra computer e impostazioni cultura.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.

Le classi derivate da Encoding consentono di scegliere una strategia di fallback che determina come vengono gestiti i caratteri che non possono essere codificati in una sequenza di byte o che non possono essere decodificate in caratteri, byte.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. È possibile scegliere uno dei seguenti:You can choose one of the following:

  • Fallback di eccezione.Exception fallback. È possibile scegliere di generare eccezioni in errori di dati tramite un throwonerror flag che è disponibile in alcuni costruttori della classe o usando il EncoderExceptionFallback e DecoderExceptionFallback classi.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. Se si è preoccupati per l'integrità del flusso di dati, è consigliabile generare un'eccezione.If you are concerned about the integrity of the data stream, throwing on an exception is recommended.

  • Fallback di sostituzione.Replacement fallback. È possibile usare la EncoderFallback e DecoderFallback alle classi di cambiare automaticamente un carattere "?" o il carattere di sostituzione 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).

  • Fallback con mapping più appropriato.Best-fit fallback. Questa opzione esegue il mapping di un carattere in una codifica a un carattere in un'altra codifica.This option maps a character in one encoding to a character in another encoding. Il fallback più appropriato spesso non è consigliabile perché può causare la perdita di dati e la confusione e più semplice lenta "?" sostituzioni di caratteri.Best fit fallback is often not recommended because it can cause data loss and confusion, and is slower than simple "?" character replacements. Per le tabelle codici ANSI, tuttavia, il comportamento più appropriato è il valore predefinito.However, for ANSI code pages the best-fit behavior is the default.

Il StringBuilder classe è progettata per le operazioni che eseguono modifiche estese in un'unica stringa.The StringBuilder class is designed for operations that perform extensive manipulations on a single string. A differenza di String (classe), il StringBuilder classe è modificabile e offre prestazioni migliori durante la concatenazione o l'eliminazione di stringhe.Unlike the String class, the StringBuilder class is mutable and provides better performance when concatenating or deleting strings.

Per altre informazioni sulle System.Text, vedere codifica dei caratteri in .NET Framework .For more information about System.Text, see Character Encoding in the .NET Framework .