ASCIIEncoding Sınıf

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Text.Encoding.Extensions.dll

Kaynak:

ASCIIEncoding.cs

Unicode karakterlerin ASCII karakter kodlamalarını temsil eder.

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

public class ASCIIEncoding : System.Text.Encoding

type ASCIIEncoding = class
    inherit Encoding

Public Class ASCIIEncoding
Inherits Encoding

Devralma

Object

Encoding

ASCIIEncoding

Örnekler

Aşağıdaki örnekte Unicode karakterlerin ASCII olarak nasıl kodlanacakları gösterilmektedir. Uygulamanız ASCII aralığının dışında Unicode karakterleri kodlamak için kullandığında ASCIIEncoding oluşan veri kaybına dikkat edin.

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

Açıklamalar

Kodlama, bir Unicode karakter kümesini bayt dizisine dönüştürme işlemidir. Kod çözme, kodlanmış bayt dizisini unicode karakter kümesine dönüştürme işlemidir.

ASCIIEncoding 20127 Windows kod sayfasına karşılık gelir. ASCII 7 bit kodlama olduğundan, ASCII karakterleri U+0000'den U+007F'ye kadar en düşük 128 Unicode karakterle sınırlıdır. Özellik veya oluşturucu tarafından döndürülen varsayılan kodlayıcıyı Encoding.ASCIIASCIIEncoding kullanırsanız, kodlama işlemi gerçekleştirilmeden önce bu aralığın dışındaki karakterler soru işareti (?) ile değiştirilir. ASCIIEncoding sınıfı yalnızca sınırlı bir karakter kümesini desteklediğindenUTF8Encoding, , UnicodeEncodingve UTF32Encoding sınıfları genelleştirilmiş uygulamalar için daha uygundur. Aşağıdaki noktalar, kullanıp kullanmayacağınız ASCIIEncodingkonusunda karar vermenize yardımcı olabilir:

• Bazı protokoller için ASCII veya ASCII alt kümesi gerekir. Bu durumlarda ASCII kodlaması uygundur.

• 8 bit kodlama bekleniyorsa, ASCII büyük olasılıkla doğru seçim değildir. Bunun yerine, ASCII yerine UTF8 kullanmayı göz önünde bulundurun. U+0000 ile U+007F arasındaki karakterler için sonuçlar aynıdır, ancak tüm Unicode karakterler UTF-8 ile temsil edilebilir ve bu da veri kaybını önler.

Dikkat

ASCIIEncoding hata algılama sağlamaz. Güvenlik nedeniyle , UnicodeEncodingveya UTF32Encoding kullanmanız UTF8Encodingve hata algılamayı etkinleştirmeniz gerekir.

GetByteCount yöntemi, bir Unicode karakter kümesinin kaç bayt ile kodlandığını belirler ve GetBytes yöntem gerçek kodlamayı gerçekleştirir.

Benzer şekilde yöntemi, GetCharCount bayt dizisinin kodunun çözülmesiyle sonuçlanan karakter sayısını belirler ve GetChars ve GetString yöntemleri gerçek kod çözme işlemini gerçekleştirir.

Varsayılan ASCIIEncoding oluşturucunun tek başına uygulamanız için uygun davranışa sahip olmadığını unutmayın. 8. bit kümesine EncoderFallback sahip sıraları engellemek için veya olarak veya DecoderFallbackEncoderExceptionFallbackDecoderExceptionFallback özelliğini ayarlamayı düşünebilirsiniz. Özel davranış bu durumlar için de uygun olabilir.

Oluşturucular

ASCIIEncoding()

ASCIIEncoding sınıfının yeni bir örneğini başlatır.

Özellikler

BodyName	Türetilmiş bir sınıfta geçersiz kılındığında, posta aracısı gövde etiketleriyle kullanılabilen geçerli kodlama için bir ad alır. (Devralındığı yer: Encoding)
CodePage	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli Encodingöğesinin kod sayfası tanımlayıcısını alır. (Devralındığı yer: Encoding)
DecoderFallback	Geçerli Encoding nesnenin DecoderFallback nesnesini alır veya ayarlar. (Devralındığı yer: Encoding)
EncoderFallback	Geçerli Encoding nesnenin EncoderFallback nesnesini alır veya ayarlar. (Devralındığı yer: Encoding)
EncodingName	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın insan tarafından okunabilir açıklamasını alır. (Devralındığı yer: Encoding)
HeaderName	Türetilmiş bir sınıfta geçersiz kılındığında, posta aracısı üst bilgi etiketleriyle kullanılabilen geçerli kodlama için bir ad alır. (Devralındığı yer: Encoding)
IsBrowserDisplay	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın içeriği görüntülemek için tarayıcı istemcileri tarafından kullanılıp kullanılamayacağını belirten bir değer alır. (Devralındığı yer: Encoding)
IsBrowserSave	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın içeriği kaydetmek için tarayıcı istemcileri tarafından kullanılıp kullanılamayacağını belirten bir değer alır. (Devralındığı yer: Encoding)
IsMailNewsDisplay	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın posta ve haber istemcileri tarafından içerik görüntülemek için kullanılıp kullanılamayacağını belirten bir değer alır. (Devralındığı yer: Encoding)
IsMailNewsSave	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın içeriği kaydetmek için posta ve haber istemcileri tarafından kullanılıp kullanılamayacağını belirten bir değer alır. (Devralındığı yer: Encoding)
IsReadOnly	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın salt okunur olup olmadığını belirten bir değer alır. (Devralındığı yer: Encoding)
IsSingleByte	Geçerli kodlamanın tek bayt kod noktaları kullanıp kullanmadığını belirten bir değer alır.
Preamble	Türetilmiş bir sınıfta geçersiz kılındığında, kullanılan kodlamayı belirten bayt dizisini içeren bir span döndürür. (Devralındığı yer: Encoding)
WebName	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlama için İnternet Atanmış Numaralar Yetkilisi'ne (IANA) kaydedilen adı alır. (Devralındığı yer: Encoding)
WindowsCodePage	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamaya en yakın olan Windows işletim sistemi kod sayfasını alır. (Devralındığı yer: Encoding)

Yöntemler

Clone()	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli Encoding nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: Encoding)
Equals(Object)	Belirtilen Object değerin geçerli örneğe eşit olup olmadığını belirler. (Devralındığı yer: Encoding)
GetByteCount(Char*, Int32)	Belirtilen karakter işaretçisinde başlayan bir karakter kümesini kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(Char[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri kodlayarak üretilen bayt sayısını hesaplar. (Devralındığı yer: Encoding)
GetByteCount(Char[], Int32, Int32)	Belirtilen karakter dizisinden bir karakter kümesi kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(ReadOnlySpan<Char>)	Belirtilen karakter aralığını kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(String)	Belirtilen Stringiçindeki karakterleri kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(String, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizeden bir karakter kümesi kodlayarak üretilen bayt sayısını hesaplar. (Devralındığı yer: Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	Belirtilen karakter işaretçisinde başlayan bir karakter kümesini, belirtilen bayt işaretçisinde başlayan bir bayt dizisine kodlar.
GetBytes(Char[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri bayt dizisine kodlar. (Devralındığı yer: Encoding)
GetBytes(Char[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki bir karakter kümesini bayt dizisine kodlar. (Devralındığı yer: Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Belirtilen karakter dizisinden bir dizi karakteri belirtilen bayt dizisine kodlar.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Belirtilen karakter aralığını belirtilen bayt aralığına kodlar.
GetBytes(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki tüm karakterleri bir bayt dizisine kodlar. (Devralındığı yer: Encoding)
GetBytes(String, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizede tarafından count belirtilen karakter sayısını belirtilenden başlayarak bayt dizisine indexkodlar. (Devralındığı yer: Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Belirtilenden bir karakter kümesini belirtilen String bayt dizisine kodlar.
GetCharCount(Byte*, Int32)	Belirtilen bayt işaretçisinde başlayan bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu çözerek üretilen karakter sayısını hesaplar. (Devralındığı yer: Encoding)
GetCharCount(Byte[], Int32, Int32)	Belirtilen bayt dizisinden bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(ReadOnlySpan<Byte>)	Belirtilen bayt aralığının kodunu çözerek üretilen karakter sayısını hesaplar.
GetChars(Byte*, Int32, Char*, Int32)	Belirtilen bayt işaretçisinde başlayan bayt dizisinin kodunu, belirtilen karakter işaretçisinde başlayan bir dizi karaktere dönüştürür.
GetChars(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu bir karakter kümesine çözer. (Devralındığı yer: Encoding)
GetChars(Byte[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bayt dizisinin kodunu bir karakter kümesine çözer. (Devralındığı yer: Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Belirtilen bayt dizisinden belirtilen karakter dizisine bayt dizisinin kodunu çözer.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Belirtilen bayt aralığının kodunu belirtilen karakter aralığına çözer.
GetDecoder()	ASCII kodlanmış bayt dizisini Unicode karakter dizisine dönüştüren bir kod çözücü alır.
GetEncoder()	Unicode karakter dizisini ASCII kodlanmış bayt dizisine dönüştüren bir kodlayıcı alır.
GetHashCode()	Geçerli örneğin karma kodunu döndürür. (Devralındığı yer: Encoding)
GetMaxByteCount(Int32)	Belirtilen karakter sayısını kodlayarak üretilen en fazla bayt sayısını hesaplar.
GetMaxCharCount(Int32)	Belirtilen bayt sayısının kodunu çözerek üretilen en fazla karakter sayısını hesaplar.
GetPreamble()	Türetilmiş bir sınıfta geçersiz kılındığında, kullanılan kodlamayı belirten bir bayt dizisi döndürür. (Devralındığı yer: Encoding)
GetString(Byte*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen adresten başlayan belirtilen bayt sayısının kodunu bir dizeye çözer. (Devralındığı yer: Encoding)
GetString(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu bir dizeye çözer. (Devralındığı yer: Encoding)
GetString(Byte[], Int32, Int32)	Bayt dizisinden dizeye bayt aralığının kodunu çözer.
GetString(ReadOnlySpan<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt aralığındaki tüm baytların kodunu bir dizeye çözer. (Devralındığı yer: Encoding)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsAlwaysNormalized()	Varsayılan normalleştirme formunu kullanarak geçerli kodlamanın her zaman normalleştirilip normalleştirilmediğini belirten bir değer alır. (Devralındığı yer: Encoding)
IsAlwaysNormalized(NormalizationForm)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen normalleştirme formunu kullanarak geçerli kodlamanın her zaman normalleştirilip normalleştirilmediğini belirten bir değer alır. (Devralındığı yer: Encoding)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Hedef yeterince büyükse, belirtilen salt okunur span'dan bir dizi karakter içeren bayt aralığına kodlar.
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Hedef yeterince büyükse, belirtilen salt okunur yayılma alanından bir dizi karakter aralığına kod çözer.

Uzantı Metotları

GetBytes(Encoding, ReadOnlySequence<Char>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak bir Byte diziye kodlar Encoding.
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak Encoding öğesinin bytekodunu çözer ve sonucu öğesine writeryazar.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak Encoding öğesini olarak bytekodlar ve sonucu olarak bytesdöndürür.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Belirtilen ReadOnlySpan<T> öğesini kullanarak Encoding öğesini olarak bytekodlar ve sonucu öğesine writeryazar.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak Encoding öğesinin charkodunu çözer ve sonucu öğesine writeryazar.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Belirtilen ReadOnlySequence<T>charöğesini kullanarak Encoding öğesinin kodunu çözer ve sonucu olarak charsdöndürür.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Belirtilen ReadOnlySpan<T> öğesini kullanarak Encoding öğesinin charkodunu çözer ve sonucu öğesine writeryazar.
GetString(Encoding, ReadOnlySequence<Byte>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak öğesinin kodunu bir String içine Encodingçözer.

Ayrıca bkz.

• Decoder
• Encoder
• Kodlamaları Anlama