Encoding.Convert Метод

Определение

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

System.Text

Сборка:

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, содержащий результат преобразования диапазона байтов в bytes из srcEncoding в dstEncoding.

Исключения

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 из srcEncoding в dstEncoding.

Исключения

ArgumentNullException

srcEncoding null.

-или-

dstEncoding null.

-или-

bytes null.

DecoderFallbackException

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

-и-

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

EncoderFallbackException

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

-и-

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

Примеры

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

using namespace System;
using namespace System::Text;

int 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.
   array<Byte>^unicodeBytes = unicode->GetBytes( unicodeString );
   
   // Perform the conversion from one encoding to the other.
   array<Byte>^asciiBytes = Encoding::Convert( unicode, ascii, unicodeBytes );
   
   // Convert the new Byte into[] a char and[] then into a string.
   array<Char>^asciiChars = gcnew array<Char>(ascii->GetCharCount( asciiBytes, 0, asciiBytes->Length ));
   ascii->GetChars( asciiBytes, 0, asciiBytes->Length, asciiChars, 0 );
   String^ asciiString = gcnew 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 (?)

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