ASCIIEncoding Klasa

Definicja

Przestrzeń nazw:

System.Text

Zestaw:

System.Text.Encoding.Extensions.dll

Źródło:

ASCIIEncoding.cs

Reprezentuje kodowanie znaków ASCII znaków Unicode.

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

public class ASCIIEncoding : System.Text.Encoding

type ASCIIEncoding = class
    inherit Encoding

Public Class ASCIIEncoding
Inherits Encoding

Dziedziczenie

Object

Encoding

ASCIIEncoding

Przykłady

W poniższym przykładzie pokazano, jak kodować znaki Unicode do zestawu ASCII. Zwróć uwagę na utratę danych, które występują, gdy aplikacja używa ASCIIEncoding do kodowania znaków Unicode poza zakresem 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 (?).

Uwagi

Kodowanie to proces przekształcania zestawu znaków Unicode w sekwencję bajtów. Dekodowanie to proces przekształcania sekwencji zakodowanych bajtów w zestaw znaków Unicode.

ASCIIEncoding odpowiada stronie kodowej systemu Windows 20127. Ponieważ kodowanie ASCII jest kodowaniem 7-bitowym, znaki ASCII są ograniczone do najniższych 128 znaków Unicode, od U+0000 do U+007F. Jeśli używasz domyślnego kodera zwróconego Encoding.ASCII przez właściwość lub ASCIIEncoding konstruktora, znaki spoza tego zakresu są zastępowane znakiem zapytania (?) przed wykonaniem operacji kodowania. ASCIIEncoding Ponieważ klasa obsługuje tylko ograniczony zestaw znaków, UTF8Encodingklasy , UnicodeEncodingi UTF32Encoding są lepiej dostosowane do zglobalizowanych aplikacji. Poniższe zagadnienia mogą pomóc w podjęciu decyzji, czy należy używać programu ASCIIEncoding:

• Niektóre protokoły wymagają ASCII lub podzestawu ASCII. W takich przypadkach kodowanie ASCII jest odpowiednie.

• Jeśli kodowanie 8-bitowe jest oczekiwane, ASCII prawdopodobnie nie jest właściwym wyborem. Zamiast tego rozważ użycie utF8 zamiast ASCII. W przypadku znaków U+0000 do U+007F wyniki są identyczne, ale wszystkie znaki Unicode można przedstawić w formacie UTF-8, co pozwala uniknąć utraty danych.

Przestroga

ASCIIEncoding nie zapewnia wykrywania błędów. Ze względów bezpieczeństwa należy użyć funkcji UTF8Encoding, UnicodeEncodinglub UTF32Encoding i włączyć wykrywanie błędów.

Metoda GetByteCount określa, ile bajtów powoduje kodowanie zestawu znaków Unicode, a GetBytes metoda wykonuje rzeczywiste kodowanie.

Podobnie metoda określa, GetCharCount ile znaków powoduje dekodowanie sekwencji bajtów, a GetChars metody i GetString wykonują rzeczywiste dekodowanie.

Należy pamiętać, że sam konstruktor domyślny ASCIIEncoding może nie mieć odpowiedniego zachowania dla aplikacji. Warto rozważyć ustawienie EncoderFallback właściwości lub DecoderFallback na EncoderExceptionFallback wartość lub DecoderExceptionFallback , aby zapobiec sekwencjom z zestawem 8 bitów. Zachowanie niestandardowe może być również odpowiednie w tych przypadkach.

Konstruktory

ASCIIEncoding()

Inicjuje nowe wystąpienie klasy ASCIIEncoding.

Właściwości

BodyName	Po zastąpieniu w klasie pochodnej pobiera nazwę bieżącego kodowania, które może być używane z tagami treści agenta poczty. (Odziedziczone po Encoding)
CodePage	Po przesłonięciu w klasie pochodnej pobiera identyfikator strony kodowej bieżącego Encodingelementu . (Odziedziczone po Encoding)
DecoderFallback	Pobiera lub ustawia DecoderFallback obiekt dla bieżącego Encoding obiektu. (Odziedziczone po Encoding)
EncoderFallback	Pobiera lub ustawia EncoderFallback obiekt dla bieżącego Encoding obiektu. (Odziedziczone po Encoding)
EncodingName	Po zastąpieniu w klasie pochodnej pobiera czytelny dla człowieka opis bieżącego kodowania. (Odziedziczone po Encoding)
HeaderName	Po zastąpieniu w klasie pochodnej pobiera nazwę bieżącego kodowania, które może być używane z tagami nagłówka agenta poczty. (Odziedziczone po Encoding)
IsBrowserDisplay	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów przeglądarki do wyświetlania zawartości. (Odziedziczone po Encoding)
IsBrowserSave	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów przeglądarki do zapisywania zawartości. (Odziedziczone po Encoding)
IsMailNewsDisplay	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów poczty i wiadomości do wyświetlania zawartości. (Odziedziczone po Encoding)
IsMailNewsSave	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów poczty i wiadomości do zapisywania zawartości. (Odziedziczone po Encoding)
IsReadOnly	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie jest tylko do odczytu. (Odziedziczone po Encoding)
IsSingleByte	Pobiera wartość wskazującą, czy bieżące kodowanie używa punktów kodu jedno bajtowego.
Preamble	Po zastąpieniu w klasie pochodnej zwraca zakres zawierający sekwencję bajtów, która określa używane kodowanie. (Odziedziczone po Encoding)
WebName	Po zastąpieniu w klasie pochodnej pobiera nazwę zarejestrowaną w urzędzie IANA (Internet Assigned Numbers Authority) dla bieżącego kodowania. (Odziedziczone po Encoding)
WindowsCodePage	Po zastąpieniu w klasie pochodnej pobiera stronę kodową systemu operacyjnego Windows, która najbardziej odpowiada bieżącemu kodowaniu. (Odziedziczone po Encoding)

Metody

Clone()	Po zastąpieniu w klasie pochodnej tworzy płytkią kopię bieżącego Encoding obiektu. (Odziedziczone po Encoding)
Equals(Object)	Określa, czy określona Object wartość jest równa bieżącemu wystąpieniu. (Odziedziczone po Encoding)
GetByteCount(Char*, Int32)	Oblicza liczbę bajtów generowanych przez kodowanie zestawu znaków rozpoczynających się od określonego wskaźnika znaków.
GetByteCount(Char[])	Podczas zastępowania w klasie pochodnej oblicza liczbę bajtów wygenerowanych przez kodowanie wszystkich znaków w określonej tablicy znaków. (Odziedziczone po Encoding)
GetByteCount(Char[], Int32, Int32)	Oblicza liczbę bajtów generowanych przez kodowanie zestawu znaków z określonej tablicy znaków.
GetByteCount(ReadOnlySpan<Char>)	Oblicza liczbę bajtów generowanych przez kodowanie określonego zakresu znaków.
GetByteCount(String)	Oblicza liczbę bajtów generowanych przez kodowanie znaków w określonym Stringobiekcie .
GetByteCount(String, Int32, Int32)	Podczas zastępowania w klasie pochodnej oblicza liczbę bajtów generowanych przez kodowanie zestawu znaków z określonego ciągu. (Odziedziczone po Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	Koduje zestaw znaków rozpoczynający się od określonego wskaźnika znaku do sekwencji bajtów przechowywanych w określonym wskaźniku bajtów.
GetBytes(Char[])	Po zastąpieniu w klasie pochodnej koduje wszystkie znaki w określonej tablicy znaków w sekwencji bajtów. (Odziedziczone po Encoding)
GetBytes(Char[], Int32, Int32)	Po zastąpieniu w klasie pochodnej koduje zestaw znaków z określonej tablicy znaków do sekwencji bajtów. (Odziedziczone po Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Koduje zestaw znaków z określonej tablicy znaków do określonej tablicy bajtów.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Koduje określony zakres znaków do określonego zakresu bajtów.
GetBytes(String)	Po zastąpieniu w klasie pochodnej koduje wszystkie znaki w określonym ciągu w sekwencji bajtów. (Odziedziczone po Encoding)
GetBytes(String, Int32, Int32)	Po zastąpieniu w klasie pochodnej koduje do tablicy bajtów liczby znaków określonych count w określonym ciągu, począwszy od określonego index. (Odziedziczone po Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Koduje zestaw znaków z określonej String tablicy bajtów.
GetCharCount(Byte*, Int32)	Oblicza liczbę znaków generowanych przez dekodowanie sekwencji bajtów rozpoczynających się od określonego wskaźnika bajtów.
GetCharCount(Byte[])	Podczas zastępowania w klasie pochodnej oblicza liczbę znaków generowanych przez dekodowanie wszystkich bajtów w określonej tablicy bajtów. (Odziedziczone po Encoding)
GetCharCount(Byte[], Int32, Int32)	Oblicza liczbę znaków generowanych przez dekodowanie sekwencji bajtów z określonej tablicy bajtów.
GetCharCount(ReadOnlySpan<Byte>)	Oblicza liczbę znaków generowanych przez dekodowanie określonego zakresu bajtów.
GetChars(Byte*, Int32, Char*, Int32)	Dekoduje sekwencję bajtów rozpoczynającą się od określonego wskaźnika bajtów do zestawu znaków przechowywanych w określonym wskaźniku znaków.
GetChars(Byte[])	Po przesłonięciu w klasie pochodnej wszystkie bajty w określonej tablicy bajtów są dekodowane w zestawie znaków. (Odziedziczone po Encoding)
GetChars(Byte[], Int32, Int32)	Po zastąpieniu w klasie pochodnej dekoduje sekwencję bajtów z określonej tablicy bajtów do zestawu znaków. (Odziedziczone po Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Dekoduje sekwencję bajtów z określonej tablicy bajtów do określonej tablicy znaków.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Dekoduje określony zakres bajtów do określonego zakresu znaków.
GetDecoder()	Uzyskuje dekoder, który konwertuje kodowaną sekwencję bajtów ASCII na sekwencję znaków Unicode.
GetEncoder()	Uzyskuje koder, który konwertuje sekwencję znaków Unicode na kodowaną sekwencję bajtów ASCII.
GetHashCode()	Zwraca kod skrótu dla bieżącego wystąpienia. (Odziedziczone po Encoding)
GetMaxByteCount(Int32)	Oblicza maksymalną liczbę bajtów generowanych przez kodowanie określonej liczby znaków.
GetMaxCharCount(Int32)	Oblicza maksymalną liczbę znaków generowanych przez dekodowanie określonej liczby bajtów.
GetPreamble()	Po zastąpieniu w klasie pochodnej zwraca sekwencję bajtów, która określa użyte kodowanie. (Odziedziczone po Encoding)
GetString(Byte*, Int32)	Po zastąpieniu w klasie pochodnej dekoduje określoną liczbę bajtów rozpoczynających się od określonego adresu do ciągu. (Odziedziczone po Encoding)
GetString(Byte[])	Po przesłonięciu w klasie pochodnej wszystkie bajty w określonej tablicy bajtów są dekodowane w ciągu. (Odziedziczone po Encoding)
GetString(Byte[], Int32, Int32)	Dekoduje zakres bajtów z tablicy bajtów do ciągu.
GetString(ReadOnlySpan<Byte>)	Po przesłonięcia w klasie pochodnej dekoduje wszystkie bajty w określonym przedziale bajtów na ciąg. (Odziedziczone po Encoding)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsAlwaysNormalized()	Pobiera wartość wskazującą, czy bieżące kodowanie jest zawsze znormalizowane przy użyciu domyślnej formy normalizacji. (Odziedziczone po Encoding)
IsAlwaysNormalized(NormalizationForm)	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie jest zawsze znormalizowane przy użyciu określonej formy normalizacji. (Odziedziczone po Encoding)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Koduje do zakresu bajtów zestaw znaków z określonego zakresu tylko do odczytu, jeśli miejsce docelowe jest wystarczająco duże.
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Dekoduje do zakresu znaków zestaw bajtów z określonego zakresu tylko do odczytu, jeśli miejsce docelowe jest wystarczająco duże.

Metody rozszerzania

GetBytes(Encoding, ReadOnlySequence<Char>)	Koduje określony ReadOnlySequence<T> element do Byte tablicy przy użyciu określonego Encodingelementu .
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Dekoduje określony ReadOnlySequence<T> parametr , aby używać byteokreślonego Encoding parametru i zapisuje wynik na writer.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Koduje określony ReadOnlySequence<T> parametr , aby używać byteokreślonego Encoding parametru i zwraca wynik do bytes.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Koduje określony ReadOnlySpan<T> parametr , aby używać byteokreślonego Encoding parametru i zapisuje wynik w pliku writer.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Dekoduje określony ReadOnlySequence<T> parametr , aby używać charokreślonego Encoding parametru i zapisuje wynik na writer.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Dekoduje określony ReadOnlySequence<T> parametr , aby używać charokreślonego Encoding parametru i zwraca wynik do chars.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Dekoduje określony ReadOnlySpan<T> parametr , aby używać charokreślonego Encoding parametru i zapisuje wynik na writer.
GetString(Encoding, ReadOnlySequence<Byte>)	Dekoduje określony ReadOnlySequence<T> element do String przy użyciu określonego Encodingelementu .

Zobacz też

• Decoder
• Encoder
• Opis kodowania