Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Encoding.ASCII Property

Gets an encoding for the ASCII (7 bit) character set.

[Visual Basic]
Public Shared ReadOnly Property ASCII As Encoding
[C#]
public static Encoding ASCII {get;}
[C++]
public: __property static Encoding* get_ASCII();
[JScript]
public static function get ASCII() : Encoding;

Property Value

An encoding for the ASCII (7 bit) character set.

Remarks

ASCII characters are limited to the lowest 128 Unicode characters, from U+0000 to U+007f.

Example

[Visual Basic] 
Imports System
Imports System.Text
Imports Microsoft.VisualBasic

Namespace Encoding_Examples
    Class EncodingExample
        Public Shared Sub Main()
            ' Create and ASCII encoding.
            Dim ascii As Encoding = Encoding.ASCII

            ' 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(&H03A0) & ") and Sigma (" & ChrW(&H03A3) & ")."
            Console.WriteLine("Original string:")
            Console.WriteLine(unicodeString)

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

            ' Encode the 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 a 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
End Namespace

[C#] 
using System;
using System.Text;

namespace Encoding_Examples
{
    using System;
    using System.Text;

    class EncodingExample 
    {
        public static void Main() 
        {
            // Create an ASCII encoding.
            Encoding ascii = Encoding.ASCII;
        
            // 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 the positions of the special characters for later reference.
            int indexOfPi = unicodeString.IndexOf('\u03a0');
            int indexOfSigma = unicodeString.IndexOf('\u03a3');

            // Encode the 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 a string.
            // Notice missing the Pi and Sigma characters.
            String decodedString = ascii.GetString(encodedBytes);
            Console.WriteLine();
            Console.WriteLine("Decoded bytes:");
            Console.WriteLine(decodedString);
        }
    }
}

[C++] 
#using <mscorlib.dll>
using namespace System;
using namespace System::Text;
using namespace System::Collections;

int main()
{
   // Create an ASCII encoding.
   Encoding * ascii = Encoding::ASCII;

   // A Unicode String* with two characters outside the ASCII code range.
   String * unicodeString =
      S"This unicode string contains two characters with codes outside the ASCII code range, Pi (\u03a0) and Sigma (\u03a3).";
   Console::WriteLine(S"Original string:");
   Console::WriteLine(unicodeString);

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

   // Encode the String*.
   Byte encodedBytes[] = ascii -> GetBytes(unicodeString);
   Console::WriteLine();
   Console::WriteLine(S"Encoded bytes:");
   IEnumerator* myEnum = encodedBytes->GetEnumerator();
   while (myEnum->MoveNext())
   {
      Byte b = *__try_cast<Byte __gc*>(myEnum->Current);
      Console::Write(S"[{0}]", __box(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(S"Value at position of Pi character: {0}",
      encodedBytes->Item[indexOfPi]);
   Console::WriteLine(S"Value at position of Sigma character: {0}",
      encodedBytes->Item[indexOfSigma]);

   // Decode bytes back to String*.
   // Notice the missing Pi and Sigma characters.
   String * decodedString = ascii -> GetString(encodedBytes);
   Console::WriteLine();
   Console::WriteLine(S"Decoded bytes:");
   Console::WriteLine(decodedString);
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

Encoding Class | Encoding Members | System.Text Namespace

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft