System.Text Przestrzeń nazw

System.Text Przestrzeń nazw zawiera klasy reprezentujące kodowania znaków ASCII i Unicode; abstrakcyjnych klas bazowych do konwertowania bloki znaków do i z bloków bajtów; i pomocnikiem klasy, który obsługuje i formatuje String obiektów bez tworzenia wystąpienia pośrednich 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.

Klasy

ASCIIEncoding

Reprezentuje kodowanie znaków ASCII znaków Unicode.Represents an ASCII character encoding of Unicode characters.

CodePagesEncodingProvider

Zapewnia dostęp do dostawcy kodowania dla stron kodowych, które w przeciwnym razie są dostępne tylko na pulpicie .NET Framework.Provides access to an encoding provider for code pages that otherwise are available only in the desktop .NET Framework.

Decoder

Konwertuje sekwencję zakodowanych bajtów na zestaw znaków.Converts a sequence of encoded bytes into a set of characters.

DecoderExceptionFallback

Zapewnia mechanizm obsługi niepowodzeń o nazwie Fallback dla kodowanej sekwencji bajtów, która nie może zostać przekonwertowana na znak wejściowy.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an input character. Rezerwa zgłasza wyjątek, zamiast dekodować sekwencję bajtów wejściowych.The fallback throws an exception instead of decoding the input byte sequence. Klasa ta nie może być dziedziczona.This class cannot be inherited.

DecoderExceptionFallbackBuffer

Zgłasza DecoderFallbackException , gdy nie można przekonwertować zakodowanej sekwencji bajtów wejściowych na zdekodowany znak wyjściowy.Throws DecoderFallbackException when an encoded input byte sequence cannot be converted to a decoded output character. Klasa ta nie może być dziedziczona.This class cannot be inherited.

DecoderFallback

Zapewnia mechanizm obsługi niepowodzeń o nazwie Fallback dla kodowanej sekwencji bajtów, która nie może zostać przekonwertowana na znak wyjściowy.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character.

DecoderFallbackBuffer

Udostępnia bufor, który umożliwia programowi obsługi rezerwowej zwracanie alternatywnego ciągu do dekodera, gdy nie można zdekodować sekwencji bajtów wejściowych.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

Wyjątek, który jest generowany, gdy operacja powrotu dekodera nie powiedzie się.The exception that is thrown when a decoder fallback operation fails. Klasa ta nie może być dziedziczona.This class cannot be inherited.

DecoderReplacementFallback

Zapewnia mechanizm obsługi niepowodzeń o nazwie Fallback dla kodowanej sekwencji bajtów, która nie może zostać przekonwertowana na znak wyjściowy.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character. Rezerwa emituje określony przez użytkownika ciąg zastępczy zamiast dekodowanej sekwencji bajtów.The fallback emits a user-specified replacement string instead of a decoded input byte sequence. Klasa ta nie może być dziedziczona.This class cannot be inherited.

DecoderReplacementFallbackBuffer

Reprezentuje zastępczy ciąg wyjściowy, który jest emitowany, gdy nie można zdekodować oryginalnej wejściowej sekwencji bajtów.Represents a substitute output string that is emitted when the original input byte sequence cannot be decoded. Klasa ta nie może być dziedziczona.This class cannot be inherited.

Encoder

Konwertuje zestaw znaków na sekwencję bajtów.Converts a set of characters into a sequence of bytes.

EncoderExceptionFallback

Zapewnia mechanizm obsługi niepowodzeń o nazwie Fallback dla znaku wejściowego, którego nie można przekonwertować na sekwencję bajtów wyjściowych.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. Rezerwa zgłasza wyjątek, jeśli nie można przekonwertować znaku wejściowego na sekwencję bajtów wyjściowych.The fallback throws an exception if an input character cannot be converted to an output byte sequence. Klasa ta nie może być dziedziczona.This class cannot be inherited.

EncoderExceptionFallbackBuffer

Zgłasza EncoderFallbackException , gdy nie można przekonwertować znaku wejściowego na zakodowaną sekwencję bajtów wyjściowych.Throws EncoderFallbackException when an input character cannot be converted to an encoded output byte sequence. Klasa ta nie może być dziedziczona.This class cannot be inherited.

EncoderFallback

Zapewnia mechanizm obsługi niepowodzeń o nazwie Fallback dla znaku wejściowego, którego nie można przekonwertować na zakodowaną sekwencję bajtów wyjściowych.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an encoded output byte sequence.

EncoderFallbackBuffer

Udostępnia bufor, który umożliwia procedury obsługi rezerwowej zwraca alternatywny ciąg do kodera, gdy nie może zakodować znaku wejściowego.Provides a buffer that allows a fallback handler to return an alternate string to an encoder when it cannot encode an input character.

EncoderFallbackException

Wyjątek, który jest generowany, gdy operacja powrotu do kodera nie powiedzie się.The exception that is thrown when an encoder fallback operation fails. Klasa ta nie może być dziedziczona.This class cannot be inherited.

EncoderReplacementFallback

Zapewnia mechanizm obsługi niepowodzeń o nazwie Fallback dla znaku wejściowego, którego nie można przekonwertować na sekwencję bajtów wyjściowych.Provides a failure handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. Funkcja Fallback używa ciągu zastępczego określonego przez użytkownika zamiast oryginalnego znaku wejściowego.The fallback uses a user-specified replacement string instead of the original input character. Klasa ta nie może być dziedziczona.This class cannot be inherited.

EncoderReplacementFallbackBuffer

Reprezentuje zastępczy ciąg wejściowy, który jest używany, gdy nie można zakodować oryginalnego znaku wejściowego.Represents a substitute input string that is used when the original input character cannot be encoded. Klasa ta nie może być dziedziczona.This class cannot be inherited.

Encoding

Reprezentuje kodowanie znaków.Represents a character encoding.

EncodingInfo

Zawiera podstawowe informacje o kodowaniu.Provides basic information about an encoding.

EncodingProvider

Dostarcza klasę bazową dla dostawcy kodowania, która dostarcza kodowania, które są niedostępne na określonej platformie.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

StringBuilder

Reprezentuje modyfikowalny ciąg znaków.Represents a mutable string of characters. Klasa ta nie może być dziedziczona.This class cannot be inherited.

UnicodeEncoding

Reprezentuje kodowanie UTF-16 znaków Unicode.Represents a UTF-16 encoding of Unicode characters.

UTF32Encoding

Reprezentuje kodowanie UTF-32 znaków Unicode.Represents a UTF-32 encoding of Unicode characters.

UTF7Encoding

Reprezentuje kodowanie UTF-7 znaków Unicode.Represents a UTF-7 encoding of Unicode characters.

UTF8Encoding

Reprezentuje kodowanie UTF-8 znaków Unicode.Represents a UTF-8 encoding of Unicode characters.

Struktury

Rune

Reprezentuje wartość skalarną Unicode ([U + 0000.. U + D7FF], włącznie; lub [U + E000.. U + 10FFFF], włącznie).Represents a Unicode scalar value ([ U+0000..U+D7FF ], inclusive; or [ U+E000..U+10FFFF ], inclusive).

SpanRuneEnumerator

Dostarcza moduł wyliczający dla Rune wartości reprezentowanych przez zakres zawierający tekst w formacie UTF-16.Provides an enumerator for the Rune values represented by a span containing UTF-16 text.

StringBuilder.ChunkEnumerator

Obsługuje prostą iterację dla fragmentów StringBuilder wystąpienia.Supports simple iteration over the chunks of a StringBuilder instance.

StringRuneEnumerator

Dostarcza moduł wyliczający dla Rune wartości reprezentowanych przez ciąg.Provides an enumerator for the Rune values represented by a string.

Wyliczenia

NormalizationForm

Definiuje typ normalizacji do wykonania.Defines the type of normalization to perform.

Uwagi

Klas kodowania są głównie przeznaczone do konwersji między różnych kodowań lub stron kodowych i kodowanie Unicode.The encoding classes are primarily intended to convert between different encodings or code pages and a Unicode encoding. Encoding.Unicode Kodowanie (UTF-16) jest używana wewnętrznie przez program .NET Framework i Encoding.UTF8 kodowanie jest często używany do przechowywania danych znaku do zapewnić Przenoszalność maszyn i kultur.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.

Klasy pochodne Encoding umożliwiają wybranie strategia rezerwowa, określający, jak znaki, które nie może zostać zakodowana w sekwencji bajtów i bajtów, które nie mogą zostać zdekodowane na znaki, są obsługiwane.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. Można wybrać jedną z następujących czynności:You can choose one of the following:

  • Wyjątek rezerwowego.Exception fallback. Użytkownik może zgłaszać wyjątki na błędy danych, za pomocą throwonerror flagę, która jest dostępna w niektóre Konstruktory klasy lub za pomocą EncoderExceptionFallback i DecoderExceptionFallback klasy.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. Jeśli jesteś zajmującym się ochroną integralności strumienia danych, zgłaszanie po wystąpieniu wyjątku jest zalecane.If you are concerned about the integrity of the data stream, throwing on an exception is recommended.

  • Zastąpienie rezerwowego.Replacement fallback. Możesz użyć EncoderFallback i DecoderFallback klasy dyskretnie zmienić znak "?" lub znak zastępczy 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).

  • Rezerwa najlepszego dopasowania.Best-fit fallback. Ta opcja mapuje znaku w taki sam znak w innym kodowaniu.This option maps a character in one encoding to a character in another encoding. Najlepsze dopasowanie rezerwowe często nie jest zalecane, ponieważ może to spowodować utratę danych i nieporozumień i jest mniejsza niż proste "?" znak zamiany.Best fit fallback is often not recommended because it can cause data loss and confusion, and is slower than simple "?" character replacements. Dla stron kodowych ANSI najlepszego dopasowania zachowanie jest domyślne.However, for ANSI code pages the best-fit behavior is the default.

StringBuilder Klasa jest przeznaczona dla operacji, które wykonują rozbudowane manipulacje na pojedynczy ciąg.The StringBuilder class is designed for operations that perform extensive manipulations on a single string. W odróżnieniu od String klasy StringBuilder klasy jest modyfikowalna oraz zapewnia lepszą wydajność podczas łączenia lub usuwanie ciągów.Unlike the String class, the StringBuilder class is mutable and provides better performance when concatenating or deleting strings.

Aby uzyskać więcej informacji na temat System.Text, zobacz kodowanie znaków na platformie .NET Framework .For more information about System.Text, see Character Encoding in the .NET Framework .