Encoding.Convert Метод

Определение

Пространство имен:

System.Text

Сборки:

netstandard.dll, System.Runtime.dll

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

Перегрузки

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

Convert(Encoding, Encoding, Byte[], Int32, Int32)

Исходный код:

Encoding.cs

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

public:
 static cli::array <System::Byte> ^ Convert(System::Text::Encoding ^ srcEncoding, System::Text::Encoding ^ dstEncoding, cli::array <System::Byte> ^ bytes, int index, int count);

public static byte[] Convert(System.Text.Encoding srcEncoding, System.Text.Encoding dstEncoding, byte[] bytes, int index, int count);

static member Convert : System.Text.Encoding * System.Text.Encoding * byte[] * int * int -> byte[]

Public Shared Function Convert (srcEncoding As Encoding, dstEncoding As Encoding, bytes As Byte(), index As Integer, count As Integer) As Byte()

Параметры

srcEncoding

Encoding

Кодировка исходного массива bytes.

dstEncoding

Encoding

Кодировка выходного массива.

bytes

Byte[]

Массив байтов для преобразования.

index

Int32

Индекс первого элемента bytes для преобразования.

count

Int32

Количество преобразованных байтов.

Возвращаемое значение

Byte[]

Массив типаByte, содержащий результат преобразования диапазона байтов в srcEncodingbytesdstEncoding.

Исключения

ArgumentNullException

srcEncoding равно null.

-или-

dstEncoding равно null.

-или-

bytes равно null.

ArgumentOutOfRangeException

index и count не указывайте допустимый диапазон в массиве байтов.

DecoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

srcEncoding.DecoderFallback имеет значение DecoderExceptionFallback.

EncoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

dstEncoding.EncoderFallback имеет значение EncoderExceptionFallback.

Convert(Encoding, Encoding, Byte[])

Исходный код:

Encoding.cs

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

public:
 static cli::array <System::Byte> ^ Convert(System::Text::Encoding ^ srcEncoding, System::Text::Encoding ^ dstEncoding, cli::array <System::Byte> ^ bytes);

public static byte[] Convert(System.Text.Encoding srcEncoding, System.Text.Encoding dstEncoding, byte[] bytes);

static member Convert : System.Text.Encoding * System.Text.Encoding * byte[] -> byte[]

Public Shared Function Convert (srcEncoding As Encoding, dstEncoding As Encoding, bytes As Byte()) As Byte()

Параметры

srcEncoding

Encoding

Формат bytesкодирования .

dstEncoding

Encoding

Формат целевой кодировки.

bytes

Byte[]

Преобразованные байты.

Возвращаемое значение

Byte[]

Массив типа Byte , содержащий результаты преобразования bytes из srcEncodingdstEncoding.

Исключения

ArgumentNullException

srcEncoding равно null.

-или-

dstEncoding равно null.

-или-

bytes равно null.

DecoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

srcEncoding.DecoderFallback имеет значение DecoderExceptionFallback.

EncoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

dstEncoding.EncoderFallback имеет значение EncoderExceptionFallback.

Примеры

В следующем примере строка в кодировке Юникод преобразуется в строку в кодировке ASCII. Так как объект кодирования ASCII, возвращаемый ASCII свойством, использует резервный вариант замены, а символ Pi не является частью набора символов ASCII, символ Pi заменяется на вопросительный знак, как показано в примере.

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 (?)