Encoding.Convert Metode

Definisi

Ruang nama:

System.Text

Rakitan:

System.Runtime.dll

Mengonversi array byte dari satu pengodean ke pengodean lainnya.

Overload

Convert(Encoding, Encoding, Byte[], Int32, Int32)	Mengonversi rentang byte dalam array byte dari satu pengodean ke pengodean lainnya.
Convert(Encoding, Encoding, Byte[])	Mengonversi seluruh array byte dari satu pengodean ke pengodean lainnya.

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

Sumber:

Encoding.cs

Mengonversi rentang byte dalam array byte dari satu pengodean ke pengodean lainnya.

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

Parameter

srcEncoding

Encoding

Pengodean array sumber, bytes.

dstEncoding

Encoding

Pengodean array output.

bytes

Byte[]

Array byte yang akan dikonversi.

index

Int32

Indeks elemen pertama bytes yang akan dikonversi.

count

Int32

Jumlah byte yang akan dikonversi.

Mengembalikan

Byte[]

Array jenis Byte yang berisi hasil konversi rentang byte dalam bytes dari srcEncoding ke dstEncoding.

Pengecualian

ArgumentNullException

srcEncoding null.

-atau-

dstEncoding null.

-atau-

bytes null.

ArgumentOutOfRangeException

index dan count tidak menentukan rentang yang valid dalam array byte.

DecoderFallbackException

Fallback terjadi (untuk informasi selengkapnya, lihat Pengodean Karakter di .NET)

-dan-

srcEncoding.DecoderFallback diatur ke DecoderExceptionFallback.

EncoderFallbackException

Fallback terjadi (untuk informasi selengkapnya, lihat Pengodean Karakter di .NET)

-dan-

dstEncoding.EncoderFallback diatur ke EncoderExceptionFallback.

Convert(Encoding, Encoding, Byte[])

Sumber:

Encoding.cs

Mengonversi seluruh array byte dari satu pengodean ke pengodean lainnya.

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

Parameter

srcEncoding

Encoding

Format pengodean bytes.

dstEncoding

Encoding

Format pengodean target.

bytes

Byte[]

Byte yang akan dikonversi.

Mengembalikan

Byte[]

Array jenis Byte yang berisi hasil konversi bytes dari srcEncoding ke dstEncoding.

Pengecualian

ArgumentNullException

srcEncoding null.

-atau-

dstEncoding null.

-atau-

bytes null.

DecoderFallbackException

Fallback terjadi (untuk informasi selengkapnya, lihat Pengodean Karakter di .NET)

-dan-

srcEncoding.DecoderFallback diatur ke DecoderExceptionFallback.

EncoderFallbackException

Fallback terjadi (untuk informasi selengkapnya, lihat Pengodean Karakter di .NET)

-dan-

dstEncoding.EncoderFallback diatur ke EncoderExceptionFallback.

Contoh

Contoh berikut mengonversi string yang dikodekan Unicode menjadi string yang dikodekan ASCII. Karena objek pengodean ASCII yang dikembalikan oleh properti ASCII menggunakan penggantian fallback dan karakter Pi bukan bagian dari set karakter ASCII, karakter Pi diganti dengan tanda tanya, seperti yang ditunjukkan output dari contoh.

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