Encoding Kelas

Definisi

Ruang nama:

System.Text

Rakitan:

System.Runtime.dll

Sumber:

Encoding.cs

Mewakili pengodean karakter.

public ref class Encoding abstract : ICloneable

public abstract class Encoding : ICloneable

type Encoding = class
    interface ICloneable

Public MustInherit Class Encoding
Implements ICloneable

Warisan

Object

Encoding

Turunan

System.Text.ASCIIEncoding

System.Text.UnicodeEncoding

System.Text.UTF32Encoding

System.Text.UTF7Encoding

System.Text.UTF8Encoding

Penerapan

ICloneable

Contoh

Contoh berikut mengonversi string dari satu pengodean ke pengodean lainnya.

Catatan

Array byte[] adalah satu-satunya jenis dalam contoh ini yang berisi data yang dikodekan. .NET Char dan String jenisnya sendiri adalah Unicode, sehingga GetChars panggilan mendekode data kembali ke Unicode.

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

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk Pengodean.

Konstruktor

Encoding()	Menginisialisasi instans baru kelas Encoding.
Encoding(Int32)	Menginisialisasi instans Encoding baru kelas yang sesuai dengan halaman kode yang ditentukan.
Encoding(Int32, EncoderFallback, DecoderFallback)	Menginisialisasi instans Encoding baru kelas yang sesuai dengan halaman kode yang ditentukan dengan strategi fallback encoder dan decoder yang ditentukan.

Properti

ASCII	Mendapatkan pengodean untuk set karakter ASCII (7-bit).
BigEndianUnicode	Mendapatkan pengodean untuk format UTF-16 yang menggunakan urutan byte big endian.
BodyName	Ketika ditimpa di kelas turunan, mendapatkan nama untuk pengodean saat ini yang dapat digunakan dengan tag isi agen email.
CodePage	Ketika ditimpa di kelas turunan, mendapatkan pengidentifikasi halaman kode dari saat ini Encoding.
DecoderFallback	Mendapatkan atau mengatur DecoderFallback objek untuk objek saat ini Encoding .
Default	Mendapatkan pengodean default untuk implementasi .NET ini.
EncoderFallback	Mendapatkan atau mengatur EncoderFallback objek untuk objek saat ini Encoding .
EncodingName	Ketika ditimpa di kelas turunan, mendapatkan deskripsi yang dapat dibaca manusia dari pengodean saat ini.
HeaderName	Ketika ditimpa di kelas turunan, mendapatkan nama untuk pengodean saat ini yang dapat digunakan dengan tag header agen email.
IsBrowserDisplay	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien browser untuk menampilkan konten.
IsBrowserSave	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien browser untuk menyimpan konten.
IsMailNewsDisplay	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien email dan berita untuk menampilkan konten.
IsMailNewsSave	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien email dan berita untuk menyimpan konten.
IsReadOnly	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini bersifat baca-saja.
IsSingleByte	Saat ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini menggunakan titik kode byte tunggal.
Latin1	Mendapatkan pengodean untuk set karakter Latin1 (ISO-8859-1).
Preamble	Saat ditimpa dalam kelas turunan, mengembalikan rentang yang berisi urutan byte yang menentukan pengodean yang digunakan.
Unicode	Mendapatkan pengodean untuk format UTF-16 menggunakan urutan byte little endian.
UTF32	Mendapatkan pengodean untuk format UTF-32 menggunakan urutan byte little endian.
UTF7	Kedaluwarsa. Mendapatkan pengodean untuk format UTF-7.
UTF8	Mendapatkan pengodean untuk format UTF-8.
WebName	Ketika ditimpa di kelas turunan, nama terdaftar di Internet Assigned Numbers Authority (IANA) untuk pengodean saat ini.
WindowsCodePage	Ketika ditimpa di kelas turunan, mendapatkan halaman kode sistem operasi Windows yang paling sesuai dengan pengodean saat ini.

Metode

Clone()	Ketika ditimpa di kelas turunan, membuat salinan dangkal dari objek saat ini Encoding .
Convert(Encoding, Encoding, Byte[])	Mengonversi seluruh array byte dari satu pengodean ke yang lain.
Convert(Encoding, Encoding, Byte[], Int32, Int32)	Mengonversi rentang byte dalam array byte dari satu pengodean ke pengodean lainnya.
CreateTranscodingStream(Stream, Encoding, Encoding, Boolean)	Stream Membuat yang berfungsi untuk melakukan transkode data antara bagian dalam Encoding dan luar Encoding, mirip Convert(Encoding, Encoding, Byte[])dengan .
Equals(Object)	Menentukan apakah yang ditentukan Object sama dengan instans saat ini.
GetByteCount(Char*, Int32)	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter yang dimulai pada penunjuk karakter yang ditentukan.
GetByteCount(Char[])	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan semua karakter dalam array karakter yang ditentukan.
GetByteCount(Char[], Int32, Int32)	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dari array karakter yang ditentukan.
GetByteCount(ReadOnlySpan<Char>)	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan karakter dalam rentang karakter yang ditentukan.
GetByteCount(String)	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan karakter dalam string yang ditentukan.
GetByteCount(String, Int32, Int32)	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dari string yang ditentukan.
GetBytes(Char*, Int32, Byte*, Int32)	Saat ditimpa dalam kelas turunan, mengodekan sekumpulan karakter yang dimulai pada penunjuk karakter yang ditentukan ke dalam urutan byte yang disimpan mulai dari penunjuk byte yang ditentukan.
GetBytes(Char[])	Saat ditimpa di kelas turunan, mengodekan semua karakter dalam array karakter yang ditentukan ke dalam urutan byte.
GetBytes(Char[], Int32, Int32)	Saat ditimpa dalam kelas turunan, mengodekan sekumpulan karakter dari array karakter yang ditentukan ke dalam urutan byte.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Saat ditimpa dalam kelas turunan, mengodekan sekumpulan karakter dari array karakter yang ditentukan ke dalam array byte yang ditentukan.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Ketika ditimpa dalam kelas turunan, mengodekan ke dalam rentang byte sekumpulan karakter dari rentang baca-saja yang ditentukan.
GetBytes(String)	Saat ditimpa dalam kelas turunan, mengodekan semua karakter dalam string yang ditentukan menjadi urutan byte.
GetBytes(String, Int32, Int32)	Saat ditimpa dalam kelas turunan, mengodekan ke dalam array byte jumlah karakter yang ditentukan oleh count dalam string yang ditentukan, dimulai dari yang ditentukan index.
GetBytes(String, Int32, Int32, Byte[], Int32)	Saat ditimpa dalam kelas turunan, mengodekan sekumpulan karakter dari string yang ditentukan ke dalam array byte yang ditentukan.
GetCharCount(Byte*, Int32)	Saat ditimpa dalam kelas turunan, menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte yang dimulai dari penunjuk byte yang ditentukan.
GetCharCount(Byte[])	Saat ditimpa dalam kelas turunan, menghitung jumlah karakter yang dihasilkan dengan mendekode semua byte dalam array byte yang ditentukan.
GetCharCount(Byte[], Int32, Int32)	Saat ditimpa dalam kelas turunan, menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte dari array byte yang ditentukan.
GetCharCount(ReadOnlySpan<Byte>)	Ketika ditimpa dalam kelas turunan, menghitung jumlah karakter yang dihasilkan dengan mendekode rentang byte baca-saja yang disediakan.
GetChars(Byte*, Int32, Char*, Int32)	Saat ditimpa dalam kelas turunan, dekode urutan byte yang dimulai pada penunjuk byte yang ditentukan ke dalam sekumpulan karakter yang disimpan mulai dari penunjuk karakter yang ditentukan.
GetChars(Byte[])	Saat ditimpa di kelas turunan, dekode semua byte dalam array byte yang ditentukan menjadi sekumpulan karakter.
GetChars(Byte[], Int32, Int32)	Saat ditimpa dalam kelas turunan, dekode urutan byte dari array byte yang ditentukan menjadi sekumpulan karakter.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Saat ditimpa dalam kelas turunan, dekode urutan byte dari array byte yang ditentukan ke dalam array karakter yang ditentukan.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Saat ditimpa dalam kelas turunan, dekode semua byte dalam rentang byte baca-saja yang ditentukan menjadi rentang karakter.
GetDecoder()	Ketika ditimpa dalam kelas turunan, mendapatkan dekoder yang mengonversi urutan byte yang dikodekan menjadi urutan karakter.
GetEncoder()	Ketika ditimpa di kelas turunan, mendapatkan encoder yang mengonversi urutan karakter Unicode menjadi urutan byte yang dikodekan.
GetEncoding(Int32)	Mengembalikan pengodean yang terkait dengan pengidentifikasi halaman kode yang ditentukan.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Mengembalikan pengodean yang terkait dengan pengidentifikasi halaman kode yang ditentukan. Parameter menentukan handler kesalahan untuk karakter yang tidak dapat dikodekan dan urutan byte yang tidak dapat didekodekan.
GetEncoding(String)	Mengembalikan pengodean yang terkait dengan nama halaman kode yang ditentukan.
GetEncoding(String, EncoderFallback, DecoderFallback)	Mengembalikan pengodean yang terkait dengan nama halaman kode yang ditentukan. Parameter menentukan handler kesalahan untuk karakter yang tidak dapat dikodekan dan urutan byte yang tidak dapat didekodekan.
GetEncodings()	Mengembalikan array yang berisi semua pengodean.
GetHashCode()	Mengembalikan kode hash untuk instans saat ini.
GetMaxByteCount(Int32)	Saat ditimpa dalam kelas turunan, menghitung jumlah maksimum byte yang dihasilkan dengan mengodekan jumlah karakter yang ditentukan.
GetMaxCharCount(Int32)	Saat ditimpa dalam kelas turunan, menghitung jumlah maksimum karakter yang dihasilkan dengan mendekode jumlah byte yang ditentukan.
GetPreamble()	Saat ditimpa dalam kelas turunan, mengembalikan urutan byte yang menentukan pengodean yang digunakan.
GetString(Byte*, Int32)	Saat ditimpa di kelas turunan, dekode jumlah byte tertentu yang dimulai pada alamat tertentu menjadi string.
GetString(Byte[])	Saat ditimpa dalam kelas turunan, dekode semua byte dalam array byte yang ditentukan menjadi string.
GetString(Byte[], Int32, Int32)	Saat ditimpa dalam kelas turunan, dekode urutan byte dari array byte yang ditentukan menjadi string.
GetString(ReadOnlySpan<Byte>)	Saat ditimpa dalam kelas turunan, dekode semua byte dalam rentang byte yang ditentukan ke dalam string.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IsAlwaysNormalized()	Mendapatkan nilai yang menunjukkan apakah pengodean saat ini selalu dinormalisasi, menggunakan formulir normalisasi default.
IsAlwaysNormalized(NormalizationForm)	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini selalu dinormalisasi, menggunakan formulir normalisasi yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
RegisterProvider(EncodingProvider)	Mendaftarkan penyedia pengodean.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Mengodekan ke dalam rentang byte sekumpulan karakter dari rentang baca-saja yang ditentukan jika tujuannya cukup besar.
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Mendekode ke dalam rentang karakter sekumpulan byte dari rentang baca-saja yang ditentukan jika tujuannya cukup besar.

Metode Ekstensi

GetBytes(Encoding, ReadOnlySequence<Char>)	Mengodekan yang ditentukan ReadOnlySequence<T> ke dalam Byte array menggunakan yang ditentukan Encoding.
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Mendekode yang ditentukan ReadOnlySequence<T> ke bytes menggunakan yang ditentukan Encoding dan menulis hasilnya ke writer.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Mengodekan yang ditentukan ReadOnlySequence<T> ke bytes menggunakan yang ditentukan Encoding dan menghasilkan hasilnya ke bytes.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Mengodekan yang ditentukan ReadOnlySpan<T> ke bytes menggunakan yang ditentukan Encoding dan menulis hasilnya ke writer.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Mendekode yang ditentukan ReadOnlySequence<T> ke chars menggunakan yang ditentukan Encoding dan menulis hasilnya ke writer.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Mendekode yang ditentukan ReadOnlySequence<T> ke chars menggunakan yang ditentukan Encoding dan menghasilkan hasilnya ke chars.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Mendekode yang ditentukan ReadOnlySpan<T> ke chars menggunakan yang ditentukan Encoding dan menulis hasilnya ke writer.
GetString(Encoding, ReadOnlySequence<Byte>)	Mendekode yang ditentukan ReadOnlySequence<T> ke dalam String menggunakan yang ditentukan Encoding.

Lihat juga

• Cara menggunakan kelas pengodean karakter di .NET