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 .

Klasy

ASCIIEncoding	Reprezentuje kodowanie znaków ASCII znaków Unicode.
CodePagesEncodingProvider	Zapewnia dostęp do dostawcy kodowania dla stron kodu, które w przeciwnym razie są dostępne tylko w .NET Framework pulpitu.
Decoder	Konwertuje sekwencję zakodowanych bajtów na zestaw znaków.
DecoderExceptionFallback	Zapewnia mechanizm obsługi błędów nazywany rezerwą dla zakodowanej sekwencji bajtów wejściowych, której nie można przekonwertować na znak wejściowy. Rezerwowy element zgłasza wyjątek zamiast dekodowania sekwencji bajtów wejściowych. Klasa ta nie może być dziedziczona.
DecoderExceptionFallbackBuffer	Zgłasza, DecoderFallbackException gdy nie można przekonwertować zakodowanej sekwencji bajtów wejściowych na zdekodowany znak wyjściowy. Klasa ta nie może być dziedziczona.
DecoderFallback	Zapewnia mechanizm obsługi błędów nazywany rezerwą dla zakodowanej sekwencji bajtów wejściowych, których nie można przekonwertować na znak wyjściowy.
DecoderFallbackBuffer	Udostępnia bufor, który umożliwia programowi obsługi rezerwowej zwracanie alternatywnego ciągu do dekodera, gdy nie może dekodować sekwencji bajtów wejściowych.
DecoderFallbackException	Wyjątek zgłaszany, gdy operacja rezerwowania dekodera kończy się niepowodzeniem. Klasa ta nie może być dziedziczona.
DecoderReplacementFallback	Zapewnia mechanizm obsługi błędów, nazywany rezerwą, dla zakodowanej sekwencji bajtów wejściowych, której nie można przekonwertować na znak wyjściowy. Rezerwowy emituje określony przez użytkownika ciąg zastępczy zamiast zdekodowanej sekwencji bajtów wejściowych. Klasa ta nie może być dziedziczona.
DecoderReplacementFallbackBuffer	Reprezentuje ciąg wyjściowy zastępczy, który jest emitowany, gdy nie można dekodować oryginalnej sekwencji bajtów wejściowych. Klasa ta nie może być dziedziczona.
Encoder	Konwertuje zestaw znaków na sekwencję bajtów.
EncoderExceptionFallback	Zapewnia mechanizm obsługi błędów nazywany rezerwowym znakiem wejściowym, którego nie można przekonwertować na sekwencję bajtów wyjściowych. Rezerwowy zwraca wyjątek, jeśli nie można przekonwertować znaku wejściowego na sekwencję bajtów wyjściowych. Klasa ta nie może być dziedziczona.
EncoderExceptionFallbackBuffer	Zgłasza, EncoderFallbackException gdy nie można przekonwertować znaku wejściowego na zakodowaną sekwencję bajtów wyjściowych. Klasa ta nie może być dziedziczona.
EncoderFallback	Zapewnia mechanizm obsługi błędów nazywany rezerwą dla znaku wejściowego, którego nie można przekonwertować na zakodowaną sekwencję bajtów wyjściowych.
EncoderFallbackBuffer	Udostępnia bufor, który umożliwia programowi obsługi rezerwowej zwracanie alternatywnego ciągu do kodera, gdy nie może kodować znaku wejściowego.
EncoderFallbackException	Wyjątek zgłaszany w przypadku niepowodzenia operacji powrotu kodera. Klasa ta nie może być dziedziczona.
EncoderReplacementFallback	Zapewnia mechanizm obsługi błędów nazywany rezerwą dla znaku wejściowego, którego nie można przekonwertować na sekwencję bajtów wyjściowych. Rezerwowy używa ciągu zastępczego określonego przez użytkownika zamiast oryginalnego znaku wejściowego. Klasa ta nie może być dziedziczona.
EncoderReplacementFallbackBuffer	Reprezentuje zastępczy ciąg wejściowy, który jest używany, gdy oryginalny znak wejściowy nie może być zakodowany. Klasa ta nie może być dziedziczona.
Encoding	Reprezentuje kodowanie znaków.
EncodingExtensions	Udostępnia metody rozszerzenia dla typów kodowania, takich jak Encoding, Encoderi Decoder.
EncodingInfo	Zawiera podstawowe informacje o kodowaniu.
EncodingProvider	Udostępnia klasę bazową dla dostawcy kodowania, który dostarcza kodowanie, które są niedostępne na określonej platformie.
StringBuilder	Reprezentuje modyfikowalny ciąg znaków. Klasa ta nie może być dziedziczona.
UnicodeEncoding	Reprezentuje kodowanie UTF-16 znaków Unicode.
UTF32Encoding	Reprezentuje kodowanie UTF-32 znaków Unicode.
UTF7Encoding	Reprezentuje kodowanie UTF-7 znaków Unicode.
UTF8Encoding	Reprezentuje kodowanie UTF-8 znaków Unicode.

Struktury

Rune	Reprezentuje wartość skalarną Unicode ([ U+0000..U+D7FF ], włącznie; lub [ U+E000.). U+10FFFF ], włącznie).
SpanLineEnumerator	Wylicza wiersze obiektu ReadOnlySpan<T>.
SpanRuneEnumerator	Zawiera moduł wyliczający dla Rune wartości reprezentowanych przez zakres zawierający tekst UTF-16.
StringBuilder.AppendInterpolatedStringHandler	Udostępnia procedurę obsługi używaną przez kompilator języka do dołączania ciągów interpolowanych do StringBuilder wystąpień.
StringBuilder.ChunkEnumerator	Obsługuje prostą iterację fragmentów StringBuilder wystąpienia.
StringRuneEnumerator	Dostarcza moduł wyliczający dla Rune wartości reprezentowanych przez ciąg.

Wyliczenia

NormalizationForm

Definiuje typ normalizacji do wykonania.

Uwagi

Klasy kodowania są głównie przeznaczone do konwersji między różnymi kodowaniami lub stronami kodowymi a kodowaniem Unicode. 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.

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. Można wybrać jedną z następujących opcji:

• Rezerwowy wyjątek. 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 . Jeśli chodzi o integralność strumienia danych, zalecane jest wyrzucanie wyjątku.

• Alternatywa wymiany. Można użyć EncoderFallback klas i, DecoderFallback Aby dyskretnie zmienić znak na "?" lub znak zastępczy Unicode (U + FFFD).

• Najlepsze dopasowanie powrotu. Ta opcja mapuje znak w jednym kodowaniu na znak w innym kodowaniu. Opcja Najlepsza dopasowanie jest często niezalecana, ponieważ może spowodować utratę i nieporozumienie danych i jest wolniejsza niż prosta litera "?". Jednak w przypadku stron kodowych ANSI najlepszym ustawieniem jest zachowanie najlepszego dopasowania.

StringBuilderKlasa jest przeznaczona dla operacji, które wykonują szerokie manipulacje na pojedynczym ciągu. W przeciwieństwie do String klasy StringBuilder Klasa jest modyfikowalna i zapewnia lepszą wydajność podczas łączenia lub usuwania ciągów.

Aby uzyskać więcej informacji na temat System.Text , zobacz jak używać klas kodowania znaków w programie .NET .