ASCIIEncoding Třída

Definice

Obor názvů:

System.Text

Sestavení:

System.Text.Encoding.Extensions.dll

Zdroj:

ASCIIEncoding.cs

Představuje kódování znaků ASCII znaků Unicode.

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

public class ASCIIEncoding : System.Text.Encoding

type ASCIIEncoding = class
    inherit Encoding

Public Class ASCIIEncoding
Inherits Encoding

Dědičnost

Object

Encoding

ASCIIEncoding

Příklady

Následující příklad ukazuje, jak kódovat znaky Unicode do ASCII. Všimněte si ztráty dat, ke které dochází, když aplikace používá ASCIIEncoding ke kódování znaků Unicode mimo rozsah 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 (?).

Poznámky

Kódování je proces transformace sady znaků Unicode na sekvenci bajtů. Dekódování je proces transformace posloupnosti zakódovaných bajtů na sadu znaků Unicode.

ASCIIEncoding odpovídá znakové stránce Windows 20127. Protože ASCII je 7bitové kódování, znaky ASCII jsou omezeny na nejnižších 128 znaků Unicode, od U+0000 do U+007F. Pokud použijete výchozí kodér vrácený Encoding.ASCII vlastností nebo ASCIIEncoding konstruktorem, nahradí se znaky mimo tento rozsah otazníkem (?) před provedením operace kódování. Vzhledem k tomu, že ASCIIEncoding třída podporuje pouze omezenou znakovou sadu, UTF8Encodingjsou třídy , UnicodeEncodinga UTF32Encoding vhodnější pro globalizované aplikace. Následující aspekty vám můžou pomoct při rozhodování, jestli použít ASCIIEncoding:

• Některé protokoly vyžadují ASCII nebo podmnožinu ASCII. V těchto případech je vhodné kódování ASCII.

• Pokud se očekává 8bitové kódování, pak ASCII pravděpodobně není správnou volbou. Místo toho zvažte použití UTF8 místo ASCII. U znaků U+0000 až U+007F jsou výsledky stejné, ale všechny znaky Unicode jsou v kódování UTF-8 reprezentovatelné, což zabraňuje ztrátě dat.

Upozornění

ASCIIEncoding neposkytuje detekci chyb. Z bezpečnostních důvodů byste měli použít UTF8Encoding, UnicodeEncodingnebo UTF32Encoding a povolit detekci chyb.

Metoda GetByteCount určuje, kolik bajtů má za následek kódování sady znaků Unicode, a GetBytes metoda provede skutečné kódování.

Stejně tak metoda určuje, GetCharCount kolik znaků má za následek dekódování posloupnosti bajtů a GetChars metody a GetString provádějí vlastní dekódování.

Všimněte si, že výchozí ASCIIEncoding konstruktor sám o sobě nemusí mít odpovídající chování pro vaši aplikaci. Můžete zvážit nastavení EncoderFallback vlastnosti nebo DecoderFallback na EncoderExceptionFallback hodnotu nebo DecoderExceptionFallback , abyste zabránili posloupnostem s 8. bitovou sadou. Pro tyto případy může být vhodné také vlastní chování.

Konstruktory

ASCIIEncoding()

Inicializuje novou instanci ASCIIEncoding třídy .

Vlastnosti

BodyName	Při přepsání v odvozené třídě získá název pro aktuální kódování, které lze použít se značkami textu poštovního agenta. (Zděděno od Encoding)
CodePage	Při přepsání v odvozené třídě získá identifikátor znakové stránky aktuálního Encoding. (Zděděno od Encoding)
DecoderFallback	Získá nebo nastaví DecoderFallback objekt pro aktuální Encoding objekt. (Zděděno od Encoding)
EncoderFallback	Získá nebo nastaví EncoderFallback objekt pro aktuální Encoding objekt. (Zděděno od Encoding)
EncodingName	Při přepsání v odvozené třídě získá popis aktuálního kódování čitelný pro člověka. (Zděděno od Encoding)
HeaderName	Při přepsání v odvozené třídě získá název pro aktuální kódování, které lze použít se značkami hlavičky poštovního agenta. (Zděděno od Encoding)
IsBrowserDisplay	Při přepsání v odvozené třídě získá hodnotu označující, zda aktuální kódování mohou použít klienti prohlížeče pro zobrazení obsahu. (Zděděno od Encoding)
IsBrowserSave	Při přepsání v odvozené třídě získá hodnotu označující, zda aktuální kódování mohou použít klienti prohlížeče pro ukládání obsahu. (Zděděno od Encoding)
IsMailNewsDisplay	Při přepsání v odvozené třídě získá hodnotu označující, zda aktuální kódování lze použít poštovní a zpravodajské klienty pro zobrazení obsahu. (Zděděno od Encoding)
IsMailNewsSave	Při přepsání v odvozené třídě získá hodnotu označující, zda aktuální kódování lze použít poštovní a zpravodajské klienty pro ukládání obsahu. (Zděděno od Encoding)
IsReadOnly	Při přepsání v odvozené třídě získá hodnotu označující, zda je aktuální kódování jen pro čtení. (Zděděno od Encoding)
IsSingleByte	Získá hodnotu označující, zda aktuální kódování používá jedno bajtové body kódu.
Preamble	Při přepsání v odvozené třídě vrátí span obsahující sekvenci bajtů, která určuje použité kódování. (Zděděno od Encoding)
WebName	Při přepsání v odvozené třídě získá název zaregistrovaný u IANA (Internet Assigned Numbers Authority) pro aktuální kódování. (Zděděno od Encoding)
WindowsCodePage	Při přepsání v odvozené třídě získá znakovou stránku operačního systému Windows, která nejvíce odpovídá aktuálnímu kódování. (Zděděno od Encoding)

Metody

Clone()	Při přepsání v odvozené třídě vytvoří mělkou kopii aktuálního Encoding objektu. (Zděděno od Encoding)
Equals(Object)	Určuje, zda se zadaná Object hodnota rovná aktuální instanci. (Zděděno od Encoding)
GetByteCount(Char*, Int32)	Vypočítá počet bajtů vytvořených kódováním sady znaků počínaje zadaným znakovým ukazatelem.
GetByteCount(Char[])	Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním všech znaků v zadaném poli znaků. (Zděděno od Encoding)
GetByteCount(Char[], Int32, Int32)	Vypočítá počet bajtů vytvořených kódováním sady znaků ze zadaného pole znaků.
GetByteCount(ReadOnlySpan<Char>)	Vypočítá počet bajtů vytvořených kódováním zadaného rozsahu znaků.
GetByteCount(String)	Vypočítá počet bajtů vytvořených kódováním znaků v zadaném Stringznaku .
GetByteCount(String, Int32, Int32)	Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním sady znaků ze zadaného řetězce. (Zděděno od Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	Zakóduje sadu znaků začínajících na zadaném znakovém ukazateli do posloupnosti bajtů, které jsou uloženy od zadaného ukazatele bajtů.
GetBytes(Char[])	Při přepsání v odvozené třídě zakóduje všechny znaky v zadaném poli znaků do posloupnosti bajtů. (Zděděno od Encoding)
GetBytes(Char[], Int32, Int32)	Při přepsání v odvozené třídě zakóduje sadu znaků ze zadaného pole znaků do posloupnosti bajtů. (Zděděno od Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Zakóduje sadu znaků ze zadaného pole znaků do zadaného pole bajtů.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Zakóduje zadaný rozsah znaků do zadaného rozsahu bajtů.
GetBytes(String)	Při přepsání v odvozené třídě zakóduje všechny znaky v zadaném řetězci do posloupnosti bajtů. (Zděděno od Encoding)
GetBytes(String, Int32, Int32)	Při přepsání v odvozené třídě kóduje do pole bajtů počet znaků zadaný v zadaném řetězci, počínaje zadaným indexřetězcem count . (Zděděno od Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Zakóduje sadu znaků ze zadaného String pole do zadaného pole bajtů.
GetCharCount(Byte*, Int32)	Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů počínaje zadaným bajtovým ukazatelem.
GetCharCount(Byte[])	Při přepsání v odvozené třídě vypočítá počet znaků vytvořených dekódováním všech bajtů v zadaném bajtovém poli. (Zděděno od Encoding)
GetCharCount(Byte[], Int32, Int32)	Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů ze zadaného pole bajtů.
GetCharCount(ReadOnlySpan<Byte>)	Vypočítá počet znaků vytvořených dekódováním zadaného rozsahu bajtů.
GetChars(Byte*, Int32, Char*, Int32)	Dekóduje posloupnost bajtů začínající od zadaného ukazatele bajtů do sady znaků, které jsou uloženy od zadaného znakového ukazatele.
GetChars(Byte[])	Při přepsání v odvozené třídě dekóduje všechny bajty v zadaném poli bajtů do sady znaků. (Zděděno od Encoding)
GetChars(Byte[], Int32, Int32)	Při přepsání v odvozené třídě dekóduje sekvenci bajtů ze zadaného pole bajtů do sady znaků. (Zděděno od Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Dekóduje posloupnost bajtů ze zadaného pole bajtů do zadaného pole znaků.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Dekóduje zadaný rozsah bajtů do zadaného rozsahu znaků.
GetDecoder()	Získá dekodér, který převede posloupnost bajtů kódované ASCII na sekvenci znaků Unicode.
GetEncoder()	Získá kodér, který převede sekvenci znaků Unicode na posloupnost bajtů kódované ASCII.
GetHashCode()	Vrátí kód hash pro aktuální instanci. (Zděděno od Encoding)
GetMaxByteCount(Int32)	Vypočítá maximální počet bajtů vytvořených kódováním zadaného počtu znaků.
GetMaxCharCount(Int32)	Vypočítá maximální počet znaků vytvořených dekódováním zadaného počtu bajtů.
GetPreamble()	Při přepsání v odvozené třídě vrátí sekvenci bajtů, která určuje použité kódování. (Zděděno od Encoding)
GetString(Byte*, Int32)	Při přepsání v odvozené třídě dekóduje zadaný počet bajtů začínající na zadané adrese do řetězce. (Zděděno od Encoding)
GetString(Byte[])	Při přepsání v odvozené třídě dekóduje všechny bajty v zadaném poli bajtů do řetězce. (Zděděno od Encoding)
GetString(Byte[], Int32, Int32)	Dekóduje rozsah bajtů z pole bajtů do řetězce.
GetString(ReadOnlySpan<Byte>)	Při přepsání v odvozené třídě dekóduje všechny bajty v zadaném rozsahu bajtů do řetězce. (Zděděno od Encoding)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IsAlwaysNormalized()	Získá hodnotu označující, zda je aktuální kódování vždy normalizován pomocí výchozího formuláře normalizace. (Zděděno od Encoding)
IsAlwaysNormalized(NormalizationForm)	Při přepsání v odvozené třídě získá hodnotu označující, zda je aktuální kódování vždy normalizován pomocí zadané normalizační formy. (Zděděno od Encoding)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Kóduje do rozsahu bajtů sadu znaků ze zadaného rozsahu jen pro čtení, pokud je cíl dostatečně velký.
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Dekóduje do rozsahu znaků sadu bajtů ze zadaného rozsahu jen pro čtení, pokud je cíl dostatečně velký.

Metody rozšíření

GetBytes(Encoding, ReadOnlySequence<Char>)	Zakóduje zadaný ReadOnlySequence<T>Byte do pole pomocí zadaného Encoding.
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Dekóduje zadaný ReadOnlySequence<T> parametr na bytes pomocí zadaného Encoding a zapíše výsledek do writer.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Zakóduje zadané ReadOnlySequence<T> do s bytepomocí zadané Encoding hodnoty a výsledek vypíše do bytes.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Zakóduje zadané ReadOnlySpan<T> do s bytepomocí zadaného Encoding a zapíše výsledek do writer.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Dekóduje zadaný ReadOnlySequence<T> parametr na chars pomocí zadaného Encoding a zapíše výsledek do writer.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Dekóduje zadaný ReadOnlySequence<T> parametr na chars pomocí zadané Encoding hodnoty a výsledek se vypíše do chars.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Dekóduje zadaný ReadOnlySpan<T> parametr na chars pomocí zadaného Encoding a zapíše výsledek do writer.
GetString(Encoding, ReadOnlySequence<Byte>)	Dekóduje zadaný ReadOnlySequence<T> parametr na pomocí String zadaného Encoding.

Viz také

• Decoder
• Encoder
• Principy kódování