ASCIIEncoding Klass

Definition

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

public class ASCIIEncoding : System.Text.Encoding

[System.Serializable]
public class ASCIIEncoding : System.Text.Encoding

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ASCIIEncoding : System.Text.Encoding

type ASCIIEncoding = class
    inherit Encoding

[<System.Serializable>]
type ASCIIEncoding = class
    inherit Encoding

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ASCIIEncoding = class
    inherit Encoding

Public Class ASCIIEncoding
Inherits Encoding

Arv

Object

Encoding

ASCIIEncoding

Attribut

SerializableAttribute ComVisibleAttribute

Exempel

I följande exempel visas hur du kodar Unicode-tecken till ASCII. Observera förlusten av data som inträffar när programmet använder ASCIIEncoding för att koda Unicode-tecken utanför ASCII-intervallet.

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

Kommentarer

Kodning är processen att omvandla en uppsättning Unicode-tecken till en sekvens med byte. Avkodning är processen att omvandla en sekvens med kodade byte till en uppsättning Unicode-tecken.

ASCIIEncoding motsvarar Windows kodsidan 20127. Eftersom ASCII är en 7-bitars kodning är ASCII-tecken begränsade till de lägsta 128 Unicode-tecknen, från U+0000 till U+007F. Om du använder standardkodaren som returneras av Encoding.ASCII egenskapen eller ASCIIEncoding konstruktorn ersätts tecken utanför intervallet med ett frågetecken (?) innan kodningsåtgärden utförs. ASCIIEncoding Eftersom klassen endast stöder en begränsad teckenuppsättning passar klasserna UTF8Encoding, UnicodeEncodingoch UTF32Encoding bättre för globaliserade program. Följande överväganden kan hjälpa dig att avgöra om du vill använda ASCIIEncoding:

• Vissa protokoll kräver ASCII eller en delmängd av ASCII. I dessa fall är ASCII-kodning lämpligt.

• Om en 8-bitarskodning förväntas är ASCII förmodligen inte rätt val. Överväg i stället att använda UTF8 i stället för ASCII. För tecknen U+0000 till U+007F är resultaten identiska, men alla Unicode-tecken kan representeras i UTF-8, vilket förhindrar dataförlust.

Metoden GetByteCount avgör hur många byte som resulterar i kodning av en uppsättning Unicode-tecken och GetBytes metoden utför den faktiska kodningen.

GetCharCount På samma sätt avgör metoden hur många tecken som resulterar i avkodning av en sekvens med byte, och GetChars metoderna och GetString utför den faktiska avkodningen.

Observera att standardkonstruktorn ASCIIEncoding i sig kanske inte har rätt beteende för ditt program. Du kanske vill överväga att ange EncoderFallback egenskapen eller DecoderFallback till EncoderExceptionFallback eller DecoderExceptionFallback förhindra sekvenser med den 8:e bituppsättningen. Anpassat beteende kan också vara lämpligt för dessa fall.

Se även

• Decoder
• Encoder
• Förstå kodningar