Encoding Класс

Определение

Пространство имен:
System.Text
Сборки:
mscorlib.dll, System.Text.Encoding.dll
Сборка:
mscorlib.dll
Сборка:
System.Text.Encoding.dll
Сборка:
netstandard.dll

Представляет кодировку символов.

public ref class Encoding abstract
public ref class Encoding abstract : ICloneable
public abstract class Encoding
[System.Serializable]
public abstract class Encoding
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Encoding : ICloneable
public abstract class Encoding : ICloneable
type Encoding = class
[<System.Serializable>]
type Encoding = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Encoding = class
    interface ICloneable
type Encoding = class
    interface ICloneable
Public MustInherit Class Encoding
Public MustInherit Class Encoding
Implements ICloneable
Наследование
Object
Encoding
Производный
Атрибуты
SerializableAttribute ComVisibleAttribute
Реализации
ICloneable

Примеры

В следующем примере строка преобразуется из одной кодировки в другую.

Note

Массив byte[] является единственным типом в этом примере, который содержит закодированные данные. Типы .NET Char и String являются юникодами, поэтому вызов GetChars вызывает декодирование данных обратно в Юникод.

using System;
using System.Text;

class Example
{
   static void Main()
   {
      string unicodeString = "This string contains the unicode character Pi (\u03a0)";

      // Create two different encodings.
      Encoding ascii = Encoding.ASCII;
      Encoding unicode = Encoding.Unicode;

      // Convert the string into a byte array.
      byte[] unicodeBytes = unicode.GetBytes(unicodeString);

      // Perform the conversion from one encoding to the other.
      byte[] asciiBytes = Encoding.Convert(unicode, ascii, unicodeBytes);
         
      // Convert the new byte[] into a char[] and then into a string.
      char[] asciiChars = new char[ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)];
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0);
      string asciiString = new string(asciiChars);

      // Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString);
      Console.WriteLine("Ascii converted string: {0}", asciiString);
   }
}
// The example displays the following output:
//    Original string: This string contains the unicode character Pi (Π)
//    Ascii converted string: This string contains the unicode character Pi (?)

Imports System.Text

Class Example
   Shared Sub Main()
      Dim unicodeString As String = "This string contains the unicode character Pi (" & ChrW(&H03A0) & ")"

      ' Create two different encodings.
      Dim ascii As Encoding = Encoding.ASCII
      Dim unicode As Encoding = Encoding.Unicode

      ' Convert the string into a byte array.
      Dim unicodeBytes As Byte() = unicode.GetBytes(unicodeString)

      ' Perform the conversion from one encoding to the other.
      Dim asciiBytes As Byte() = Encoding.Convert(unicode, ascii, unicodeBytes)

      ' Convert the new byte array into a char array and then into a string.
      Dim asciiChars(ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)-1) As Char
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0)
      Dim asciiString As New String(asciiChars)

      ' Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString)
      Console.WriteLine("Ascii converted string: {0}", asciiString)
   End Sub
End Class
' The example displays the following output:
'    Original string: This string contains the unicode character Pi (Π)
'    Ascii converted string: This string contains the unicode character Pi (?)

Комментарии

Дополнительные сведения об этом API см. в дополнительных примечаниях API для кодирования.

Конструкторы

Имя Описание
Encoding()

Инициализирует новый экземпляр класса Encoding.
Encoding(Int32, EncoderFallback, DecoderFallback)

Инициализирует новый экземпляр Encoding класса, соответствующий указанной кодовой странице с указанными стратегиями кодировщика и декодировщика.
Encoding(Int32)

Инициализирует новый экземпляр Encoding класса, соответствующий указанной кодовой странице.

Свойства

Имя Описание
ASCII

Получает кодировку для 7-разрядного набора символов ASCII.
BigEndianUnicode

Получает кодировку для формата UTF-16, использующего порядок байтов больших байтов.
BodyName

При переопределении в производном классе получает имя текущей кодировки, которую можно использовать с тегами текста агента почты.
CodePage

При переопределении в производном классе получает идентификатор кодовой страницы текущего Encoding.
DecoderFallback

Возвращает или задает DecoderFallback объект для текущего Encoding объекта.
Default

Возвращает кодировку по умолчанию для этой реализации .NET.
EncoderFallback

Возвращает или задает EncoderFallback объект для текущего Encoding объекта.
EncodingName

При переопределении в производном классе получает удобочитаемое пользователем описание текущей кодировки.
HeaderName

При переопределении в производном классе получает имя текущей кодировки, которую можно использовать с тегами заголовков агента почты.
IsBrowserDisplay

При переопределении в производном классе получает значение, указывающее, может ли текущая кодировка использоваться клиентами браузера для отображения содержимого.
IsBrowserSave

При переопределении в производном классе получает значение, указывающее, может ли текущая кодировка использоваться клиентами браузера для сохранения содержимого.
IsMailNewsDisplay

При переопределении в производном классе получает значение, указывающее, может ли текущая кодировка использоваться почтовыми клиентами и клиентами новостей для отображения содержимого.
IsMailNewsSave

При переопределении в производном классе получает значение, указывающее, может ли текущая кодировка использоваться почтовыми клиентами и клиентами новостей для сохранения содержимого.
IsReadOnly

При переопределении в производном классе получает значение, указывающее, доступна ли текущая кодировка только для чтения.
IsSingleByte

При переопределении в производном классе получает значение, указывающее, использует ли текущая кодировка точки кода с одним байтом.
Preamble

При переопределении в производном классе возвращает диапазон, содержащий последовательность байтов, указывающую используемую кодировку.
Unicode

Получает кодировку для формата UTF-16 с помощью небольшого порядка байтов.
UTF32

Получает кодировку для формата UTF-32 с помощью небольшого порядка байтов.
UTF7

Получает кодировку для формата UTF-7.
UTF8

Получает кодировку для формата UTF-8.
WebName

При переопределении в производном классе получает имя, зарегистрированное в Центр назначения номеров Интернета (IANA) для текущей кодировки.
WindowsCodePage

При переопределении в производном классе получает кодовую страницу операционной системы Windows, которая наиболее тесно соответствует текущей кодировке.

Методы

Имя Описание
Clone()

При переопределении в производном классе создает неглубокую копию текущего Encoding объекта.
Convert(Encoding, Encoding, Byte[], Int32, Int32)

Преобразует диапазон байтов в массив байтов из одной кодировки в другую.
Convert(Encoding, Encoding, Byte[])

Преобразует весь массив байтов из одной кодировки в другую.
Equals(Object)

Определяет, равен ли указанный Object экземпляр текущему экземпляру.
GetByteCount(Char[], Int32, Int32)

При переопределении в производном классе вычисляет количество байтов, созданных путем кодирования набора символов из указанного массива символов.
GetByteCount(Char[])

При переопределении в производном классе вычисляет количество байтов, созданных путем кодирования всех символов в указанном массиве символов.
GetByteCount(Char*, Int32)

При переопределении в производном классе вычисляет количество байтов, созданных путем кодирования набора символов, начиная с указанного указателя символов.
GetByteCount(ReadOnlySpan<Char>)

При переопределении в производном классе вычисляет количество байтов, созданных путем кодирования символов в указанном диапазоне символов.
GetByteCount(String, Int32, Int32)

При переопределении в производном классе вычисляет количество байтов, созданных путем кодирования набора символов из указанной строки.
GetByteCount(String)

При переопределении в производном классе вычисляет количество байтов, созданных путем кодирования символов в указанной строке.
GetBytes(Char[], Int32, Int32, Byte[], Int32)

При переопределении в производном классе кодирует набор символов из указанного массива символов в указанный массив байтов.
GetBytes(Char[], Int32, Int32)

При переопределении в производном классе кодирует набор символов из указанного массива символов в последовательность байтов.
GetBytes(Char[])

При переопределении в производном классе кодирует все символы в указанном массиве символов в последовательность байтов.
GetBytes(Char*, Int32, Byte*, Int32)

При переопределении в производном классе кодирует набор символов, начиная с указанного указателя символов, в последовательность байтов, которые хранятся начиная с указанного указателя байтов.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)

При переопределении в производном классе кодируется в диапазон байтов набор символов из указанного диапазона только для чтения.
GetBytes(String, Int32, Int32, Byte[], Int32)

При переопределении в производном классе кодирует набор символов из указанной строки в указанный массив байтов.
GetBytes(String, Int32, Int32)

При переопределении в производном классе кодируется в массив байтов число символов, указанных count в указанной строке, начиная с указанного.index
GetBytes(String)

При переопределении в производном классе кодирует все символы в указанной строке в последовательность байтов.
GetCharCount(Byte[], Int32, Int32)

При переопределении в производном классе вычисляет количество символов, созданных путем декодирования последовательности байтов из указанного массива байтов.
GetCharCount(Byte[])

При переопределении в производном классе вычисляет количество символов, созданных путем декодирования всех байтов в указанном массиве байтов.
GetCharCount(Byte*, Int32)

При переопределении в производном классе вычисляет количество символов, созданных путем декодирования последовательности байтов, начиная с указанного указателя байтов.
GetCharCount(ReadOnlySpan<Byte>)

При переопределении в производном классе вычисляет количество символов, созданных путем декодирования предоставленного диапазона байтов только для чтения.
GetChars(Byte[], Int32, Int32, Char[], Int32)

При переопределении в производном классе декодирует последовательность байтов из указанного массива байтов в указанный массив символов.
GetChars(Byte[], Int32, Int32)

При переопределении в производном классе декодирует последовательность байтов из указанного массива байтов в набор символов.
GetChars(Byte[])

При переопределении в производном классе декодирует все байты в указанном массиве байтов в набор символов.
GetChars(Byte*, Int32, Char*, Int32)

При переопределении в производном классе декодирует последовательность байтов, начиная с указанного указателя байтов, в набор символов, которые хранятся начиная с указанного указателя символов.
GetChars(ReadOnlySpan<Byte>, Span<Char>)

При переопределении в производном классе декодирует все байты в указанном диапазоне байтов только для чтения в диапазон символов.
GetDecoder()

При переопределении в производном классе получает декодатор, который преобразует закодированную последовательность байтов в последовательность символов.
GetEncoder()

При переопределении в производном классе получает кодировщик, который преобразует последовательность символов Юникода в закодированную последовательность байтов.
GetEncoding(Int32, EncoderFallback, DecoderFallback)

Возвращает кодировку, связанную с указанным идентификатором кодовой страницы. Параметры указывают обработчик ошибок для символов, которые не могут быть закодированы и байтовые последовательности, которые не могут быть декодированы.
GetEncoding(Int32)

Возвращает кодировку, связанную с указанным идентификатором кодовой страницы.
GetEncoding(String, EncoderFallback, DecoderFallback)

Возвращает кодировку, связанную с указанным именем кодовой страницы. Параметры указывают обработчик ошибок для символов, которые не могут быть закодированы и байтовые последовательности, которые не могут быть декодированы.
GetEncoding(String)

Возвращает кодировку, связанную с указанным именем кодовой страницы.
GetEncodings()

Возвращает массив, содержащий все кодировки.
GetHashCode()

Возвращает хэш-код для текущего экземпляра.
GetMaxByteCount(Int32)

При переопределении в производном классе вычисляет максимальное количество байтов, созданных путем кодирования указанного числа символов.
GetMaxCharCount(Int32)

При переопределении в производном классе вычисляет максимальное количество символов, созданных путем декодирования указанного числа байтов.
GetPreamble()

При переопределении в производном классе возвращает последовательность байтов, указывающую используемую кодировку.
GetString(Byte[], Int32, Int32)

При переопределении в производном классе декодирует последовательность байтов из указанного массива байтов в строку.
GetString(Byte[])

При переопределении в производном классе декодирует все байты в указанном массиве байтов в строку.
GetString(Byte*, Int32)

При переопределении в производном классе декодирует указанное число байтов, начиная с указанного адреса в строку.
GetString(ReadOnlySpan<Byte>)

При переопределении в производном классе декодирует все байты в указанном диапазоне байтов в строку.
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
IsAlwaysNormalized()

Возвращает значение, указывающее, всегда ли текущая кодировка нормализована, используя форму нормализации по умолчанию.
IsAlwaysNormalized(NormalizationForm)

При переопределении в производном классе получает значение, указывающее, всегда ли текущая кодировка нормализована, используя указанную форму нормализации.
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
RegisterProvider(EncodingProvider)

Регистрирует поставщика кодирования.
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

См. также раздел