System.Text Przestrzeń nazw

Zawiera klasy, które reprezentują kodowanie znaków ASCII i Unicode; abstrakcyjne klasy podstawowe do konwertowania bloków znaków do i z bloków bajtów. i Klasa pomocnika, która operuje i formatuje String obiekty bez tworzenia wystąpień pośrednich String . 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.

EncodingExtensions

Zapewnia metody rozszerzające dla typów kodowania, takich jak Encoding , Encoder , i Decoder .Provides extension methods for the encoding types, such as Encoding, Encoder, and Decoder.

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

Klasy kodowania są głównie przeznaczone do konwersji między różnymi kodowaniami lub stronami kodowymi a kodowaniem 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żywane wewnętrznie przez platformę .NET, a Encoding.UTF8 kodowanie jest często używane do przechowywania danych znakowych w celu zapewnienia przenośności między maszynami i kulturami.Encoding.Unicode (UTF-16) encoding is used internally by .NET, and Encoding.UTF8 encoding is often used for storing character data to ensure portability across machines and cultures.

Klasy pochodzące od Encoding umożliwiają wybranie strategii awaryjnej, która określa, jak znaki, których nie można zakodować w sekwencji bajtów ani nie mogą zostać zdekodowane do znaków, 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 opcji:You can choose one of the following:

  • Rezerwowy wyjątek.Exception fallback. Można wybrać, aby generować wyjątki dotyczące błędów danych przy użyciu throwonerror flagi, która jest dostępna w niektórych konstruktorach klas lub przy użyciu EncoderExceptionFallback klas i DecoderExceptionFallback .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 chodzi o integralność strumienia danych, zalecane jest wyrzucanie wyjątku.If you are concerned about the integrity of the data stream, throwing on an exception is recommended.

  • Alternatywa wymiany.Replacement fallback. Można użyć EncoderFallback klas i, DecoderFallback Aby dyskretnie zmienić znak na "?" 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).

  • Najlepsze dopasowanie powrotu.Best-fit fallback. Ta opcja mapuje znak w jednym kodowaniu na znak w innym kodowaniu.This option maps a character in one encoding to a character in another encoding. Opcja Najlepsza dopasowanie jest często niezalecana, ponieważ może spowodować utratę i nieporozumienie danych i jest wolniejsza niż prosta litera "?".Best fit fallback is often not recommended because it can cause data loss and confusion, and is slower than simple "?" character replacements. Jednak w przypadku stron kodowych ANSI najlepszym ustawieniem jest zachowanie najlepszego dopasowania.However, for ANSI code pages the best-fit behavior is the default.

StringBuilderKlasa jest przeznaczona dla operacji, które wykonują szerokie manipulacje na pojedynczym ciągu.The StringBuilder class is designed for operations that perform extensive manipulations on a single string. W przeciwieństwie do String klasy StringBuilder Klasa jest modyfikowalna i zapewnia lepszą wydajność podczas łączenia lub usuwania 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 jak używać klas kodowania znaków w programie .NET .For more information about System.Text, see How to use character encoding classes in .NET .