ASCIIEncoding Kelas

Definisi

Ruang nama:

System.Text

Rakitan:

System.Text.Encoding.Extensions.dll

Sumber:

ASCIIEncoding.cs

Mewakili pengodean karakter ASCII dari karakter Unicode.

public ref class ASCIIEncoding : System::Text::Encoding

public class ASCIIEncoding : System.Text.Encoding

type ASCIIEncoding = class
    inherit Encoding

Public Class ASCIIEncoding
Inherits Encoding

Warisan

Object

Encoding

ASCIIEncoding

Contoh

Contoh berikut menunjukkan cara mengodekan karakter Unicode ke ascii. Perhatikan hilangnya data yang terjadi saat aplikasi Anda menggunakan ASCIIEncoding untuk mengodekan karakter Unicode di luar rentang ASCII.

using namespace System;
using namespace System::Collections;
using namespace System::Text;
int main()
{
   
   // The encoding.
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   
   // A Unicode string with two characters outside the ASCII code range.
   String^ unicodeString = L"This Unicode String* contains two characters with codes outside the ASCII code range, Pi (\u03a0) and Sigma (\u03a3).";
   Console::WriteLine( "Original String*:" );
   Console::WriteLine( unicodeString );
   
   // Save positions of the special characters for later reference.
   int indexOfPi = unicodeString->IndexOf( L'\u03a0' );
   int indexOfSigma = unicodeString->IndexOf( L'\u03a3' );
   
   // Encode string.
   array<Byte>^encodedBytes = ascii->GetBytes( unicodeString );
   Console::WriteLine();
   Console::WriteLine( "Encoded bytes:" );
   IEnumerator^ myEnum = encodedBytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "->Item[ {0}]", b );
   }

   Console::WriteLine();
   
   // Notice that the special characters have been replaced with
   // the value 63, which is the ASCII character code for '?'.
   Console::WriteLine();
   Console::WriteLine( "Value at position of Pi character: {0}", encodedBytes[ indexOfPi ] );
   Console::WriteLine( "Value at position of Sigma character: {0}", encodedBytes[ indexOfSigma ] );
   
   // Decode bytes back to string.
   // Notice missing Pi and Sigma characters.
   String^ decodedString = ascii->GetString( encodedBytes );
   Console::WriteLine();
   Console::WriteLine( "Decoded bytes:" );
   Console::WriteLine( decodedString );
}
// The example displays the following output:
//    Original string:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (Π) and Sigma (Σ).
//
//    Encoded bytes:
//    [84][104][105][115][32][85][110][105][99][111][100][101][32][115][116][114][105]
//    [110][103][32][99][111][110][116][97][105][110][115][32][116][119][111][32][99][
//    104][97][114][97][99][116][101][114][115][32][119][105][116][104][32][99][111][1
//    00][101][115][32][111][117][116][115][105][100][101][32][116][104][101][32][65][
//    83][67][73][73][32][99][111][100][101][32][114][97][110][103][101][44][32][80][1
//    05][32][40][63][41][32][97][110][100][32][83][105][103][109][97][32][40][63][41]
//    [46]
//
//    Value at position of Pi character: 63
//    Value at position of Sigma character: 63
//
//    Decoded bytes:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (?) and Sigma (?).

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        // The encoding.
        ASCIIEncoding ascii = new ASCIIEncoding();
        
        // A Unicode string with two characters outside the ASCII code range.
        String unicodeString =
            "This Unicode string contains two characters " +
            "with codes outside the ASCII code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Save positions of the special characters for later reference.
        int indexOfPi = unicodeString.IndexOf('\u03a0');
        int indexOfSigma = unicodeString.IndexOf('\u03a3');

        // Encode string.
        Byte[] encodedBytes = ascii.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
        
        // Notice that the special characters have been replaced with
        // the value 63, which is the ASCII character code for '?'.
        Console.WriteLine();
        Console.WriteLine(
            "Value at position of Pi character: {0}",
            encodedBytes[indexOfPi]
        );
        Console.WriteLine(
            "Value at position of Sigma character: {0}",
            encodedBytes[indexOfSigma]
        );

        // Decode bytes back to string.
        // Notice missing Pi and Sigma characters.
        String decodedString = ascii.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}
// The example displays the following output:
//    Original string:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (Π) and Sigma (Σ).
//
//    Encoded bytes:
//    [84][104][105][115][32][85][110][105][99][111][100][101][32][115][116][114][105]
//    [110][103][32][99][111][110][116][97][105][110][115][32][116][119][111][32][99][
//    104][97][114][97][99][116][101][114][115][32][119][105][116][104][32][99][111][1
//    00][101][115][32][111][117][116][115][105][100][101][32][116][104][101][32][65][
//    83][67][73][73][32][99][111][100][101][32][114][97][110][103][101][44][32][80][1
//    05][32][40][63][41][32][97][110][100][32][83][105][103][109][97][32][40][63][41]
//    [46]
//
//    Value at position of Pi character: 63
//    Value at position of Sigma character: 63
//
//    Decoded bytes:
//    This Unicode string contains two characters with codes outside the ASCII code ra
//    nge, Pi (?) and Sigma (?).

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        ' The encoding.
        Dim ascii As New ASCIIEncoding()

        ' A Unicode string with two characters outside the ASCII code range.
        Dim unicodeString As String = _
            "This Unicode string contains two characters " & _
            "with codes outside the ASCII code range, " & _
            "Pi (" & ChrW(928) & ") and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)

        ' Save positions of the special characters for later reference.
        Dim indexOfPi As Integer = unicodeString.IndexOf(ChrW(928))
        Dim indexOfSigma As Integer = unicodeString.IndexOf(ChrW(931))

        ' Encode string.
        Dim encodedBytes As Byte() = ascii.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Dim b As Byte
        For Each b In encodedBytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()

        ' Notice that the special characters have been replaced with
        ' the value 63, which is the ASCII character code for '?'.
        Console.WriteLine()
        Console.WriteLine( _
            "Value at position of Pi character: {0}", _
            encodedBytes(indexOfPi) _
        )
        Console.WriteLine( _
            "Value at position of Sigma character: {0}", _
            encodedBytes(indexOfSigma) _
        )

        ' Decode bytes back to string.
        ' Notice missing Pi and Sigma characters.
        Dim decodedString As String = ascii.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class
' The example displays the following output:
'    Original string:
'    This Unicode string contains two characters with codes outside the ASCII code ra
'    nge, Pi (Π) and Sigma (Σ).
'
'    Encoded bytes:
'    [84][104][105][115][32][85][110][105][99][111][100][101][32][115][116][114][105]
'    [110][103][32][99][111][110][116][97][105][110][115][32][116][119][111][32][99][
'    104][97][114][97][99][116][101][114][115][32][119][105][116][104][32][99][111][1
'    00][101][115][32][111][117][116][115][105][100][101][32][116][104][101][32][65][
'    83][67][73][73][32][99][111][100][101][32][114][97][110][103][101][44][32][80][1
'    05][32][40][63][41][32][97][110][100][32][83][105][103][109][97][32][40][63][41]
'    [46]
'
'    Value at position of Pi character: 63
'    Value at position of Sigma character: 63
'
'    Decoded bytes:
'    This Unicode string contains two characters with codes outside the ASCII code ra
'    nge, Pi (?) and Sigma (?).

Keterangan

Pengodean adalah proses mengubah sekumpulan karakter Unicode menjadi urutan byte. Pendekodean adalah proses mengubah urutan byte yang dikodekan menjadi satu set karakter Unicode.

ASCIIEncoding sesuai dengan halaman kode Windows 20127. Karena ASCII adalah pengodean 7-bit, karakter ASCII dibatasi pada karakter Unicode 128 terendah, dari U+0000 hingga U+007F. Jika Anda menggunakan encoder default yang dikembalikan oleh Encoding.ASCII properti atau ASCIIEncoding konstruktor, karakter di luar rentang tersebut diganti dengan tanda tanya (?) sebelum operasi pengodean dilakukan. ASCIIEncoding Karena kelas hanya mendukung set karakter terbatas, UTF8Encodingkelas , , UnicodeEncodingdan UTF32Encoding lebih cocok untuk aplikasi global. Pertimbangan berikut dapat membantu Anda memutuskan apakah akan menggunakan ASCIIEncoding:

• Beberapa protokol memerlukan ASCII atau subset ASCII. Dalam kasus ini pengodean ASCII sesuai.

• Jika pengodean 8-bit diharapkan, maka ASCII mungkin bukan pilihan yang benar. Sebagai gantinya, pertimbangkan untuk menggunakan UTF8 alih-alih ASCII. Untuk karakter U+0000 hingga U+007F, hasilnya identik, tetapi semua karakter Unicode dapat diwakili dalam UTF-8, yang menghindari kehilangan data.

Perhatian

ASCIIEncoding tidak memberikan deteksi kesalahan. Untuk alasan keamanan, Anda harus menggunakan UTF8Encoding, , UnicodeEncodingatau UTF32Encoding dan mengaktifkan deteksi kesalahan.

Metode ini GetByteCount menentukan berapa banyak byte yang menghasilkan pengodean sekumpulan karakter Unicode, dan GetBytes metode melakukan pengodean aktual.

Demikian juga, GetCharCount metode menentukan berapa banyak karakter yang menghasilkan pendekodean urutan byte, dan GetChars metode dan GetString melakukan decoding aktual.

Perhatikan bahwa konstruktor default ASCIIEncoding dengan sendirinya mungkin tidak memiliki perilaku yang sesuai untuk aplikasi Anda. Anda mungkin ingin mempertimbangkan untuk mengatur EncoderFallback properti atau DecoderFallback ke EncoderExceptionFallback atau DecoderExceptionFallback untuk mencegah urutan dengan set bit ke-8. Perilaku kustom mungkin juga sesuai untuk kasus ini.

Konstruktor

ASCIIEncoding()

Menginisialisasi instans baru kelas ASCIIEncoding.

Properti

BodyName	Ketika ditimpa di kelas turunan, mendapatkan nama untuk pengodean saat ini yang dapat digunakan dengan tag isi agen email. (Diperoleh dari Encoding)
CodePage	Ketika ditimpa di kelas turunan, mendapatkan pengidentifikasi halaman kode dari saat ini Encoding. (Diperoleh dari Encoding)
DecoderFallback	Mendapatkan atau mengatur DecoderFallback objek untuk objek saat ini Encoding . (Diperoleh dari Encoding)
EncoderFallback	Mendapatkan atau mengatur EncoderFallback objek untuk objek saat ini Encoding . (Diperoleh dari Encoding)
EncodingName	Ketika ditimpa di kelas turunan, mendapatkan deskripsi yang dapat dibaca manusia dari pengodean saat ini. (Diperoleh dari Encoding)
HeaderName	Ketika ditimpa di kelas turunan, mendapatkan nama untuk pengodean saat ini yang dapat digunakan dengan tag header agen email. (Diperoleh dari Encoding)
IsBrowserDisplay	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien browser untuk menampilkan konten. (Diperoleh dari Encoding)
IsBrowserSave	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien browser untuk menyimpan konten. (Diperoleh dari Encoding)
IsMailNewsDisplay	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien email dan berita untuk menampilkan konten. (Diperoleh dari Encoding)
IsMailNewsSave	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien email dan berita untuk menyimpan konten. (Diperoleh dari Encoding)
IsReadOnly	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini bersifat baca-saja. (Diperoleh dari Encoding)
IsSingleByte	Mendapatkan nilai yang menunjukkan apakah pengodean saat ini menggunakan titik kode byte tunggal.
Preamble	Saat ditimpa dalam kelas turunan, mengembalikan rentang yang berisi urutan byte yang menentukan pengodean yang digunakan. (Diperoleh dari Encoding)
WebName	Ketika ditimpa di kelas turunan, nama terdaftar di Internet Assigned Numbers Authority (IANA) untuk pengodean saat ini. (Diperoleh dari Encoding)
WindowsCodePage	Ketika ditimpa di kelas turunan, mendapatkan halaman kode sistem operasi Windows yang paling sesuai dengan pengodean saat ini. (Diperoleh dari Encoding)

Metode

Clone()	Ketika ditimpa di kelas turunan, membuat salinan dangkal dari objek saat ini Encoding . (Diperoleh dari Encoding)
Equals(Object)	Menentukan apakah yang ditentukan Object sama dengan instans saat ini. (Diperoleh dari Encoding)
GetByteCount(Char*, Int32)	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. (Diperoleh dari Encoding)
GetByteCount(Char[], Int32, Int32)	Menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dari array karakter yang ditentukan.
GetByteCount(ReadOnlySpan<Char>)	Menghitung jumlah byte yang dihasilkan dengan mengodekan rentang karakter yang ditentukan.
GetByteCount(String)	Menghitung jumlah byte yang dihasilkan dengan mengodekan karakter dalam yang ditentukan String.
GetByteCount(String, Int32, Int32)	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dari string yang ditentukan. (Diperoleh dari Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	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. (Diperoleh dari Encoding)
GetBytes(Char[], Int32, Int32)	Saat ditimpa dalam kelas turunan, mengodekan sekumpulan karakter dari array karakter yang ditentukan ke dalam urutan byte. (Diperoleh dari Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Mengodekan sekumpulan karakter dari array karakter yang ditentukan ke dalam array byte yang ditentukan.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Mengodekan rentang karakter yang ditentukan ke dalam rentang byte yang ditentukan.
GetBytes(String)	Saat ditimpa dalam kelas turunan, mengodekan semua karakter dalam string yang ditentukan menjadi urutan byte. (Diperoleh dari Encoding)
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. (Diperoleh dari Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Mengodekan sekumpulan karakter dari yang ditentukan String ke dalam array byte yang ditentukan.
GetCharCount(Byte*, Int32)	Menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte yang dimulai pada 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. (Diperoleh dari Encoding)
GetCharCount(Byte[], Int32, Int32)	Menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte dari array byte yang ditentukan.
GetCharCount(ReadOnlySpan<Byte>)	Menghitung jumlah karakter yang dihasilkan dengan mendekode rentang byte yang ditentukan.
GetChars(Byte*, Int32, Char*, Int32)	Mendekode urutan byte yang dimulai pada penunjuk byte yang ditentukan ke dalam sekumpulan karakter yang disimpan dimulai pada penunjuk karakter yang ditentukan.
GetChars(Byte[])	Saat ditimpa di kelas turunan, dekode semua byte dalam array byte yang ditentukan menjadi sekumpulan karakter. (Diperoleh dari Encoding)
GetChars(Byte[], Int32, Int32)	Saat ditimpa dalam kelas turunan, dekode urutan byte dari array byte yang ditentukan menjadi sekumpulan karakter. (Diperoleh dari Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Mendekode urutan byte dari array byte yang ditentukan ke dalam array karakter yang ditentukan.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Mendekode rentang byte yang ditentukan ke dalam rentang karakter yang ditentukan.
GetDecoder()	Mendapatkan dekoder yang mengonversi urutan byte yang dikodekan ASCII menjadi urutan karakter Unicode.
GetEncoder()	Mendapatkan encoder yang mengonversi urutan karakter Unicode menjadi urutan byte yang dikodekan ASCII.
GetHashCode()	Mengembalikan kode hash untuk instans saat ini. (Diperoleh dari Encoding)
GetMaxByteCount(Int32)	Menghitung jumlah maksimum byte yang dihasilkan dengan mengodekan jumlah karakter yang ditentukan.
GetMaxCharCount(Int32)	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. (Diperoleh dari Encoding)
GetString(Byte*, Int32)	Saat ditimpa di kelas turunan, dekode jumlah byte tertentu yang dimulai pada alamat tertentu menjadi string. (Diperoleh dari Encoding)
GetString(Byte[])	Saat ditimpa dalam kelas turunan, dekode semua byte dalam array byte yang ditentukan menjadi string. (Diperoleh dari Encoding)
GetString(Byte[], Int32, Int32)	Mendekode rentang byte dari array byte menjadi string.
GetString(ReadOnlySpan<Byte>)	Saat ditimpa dalam kelas turunan, dekode semua byte dalam rentang byte yang ditentukan ke dalam string. (Diperoleh dari Encoding)
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. (Diperoleh dari Encoding)
IsAlwaysNormalized(NormalizationForm)	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini selalu dinormalisasi, menggunakan formulir normalisasi yang ditentukan. (Diperoleh dari Encoding)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
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

• Decoder
• Encoder
• Memahami Pengodean