ASCIIEncoding Constructor ()

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Initializes a new instance of the ASCIIEncoding class.

Namespace:   System.Text
Assembly:  mscorlib (in mscorlib.dll)

public ASCIIEncoding()

System_CAPS_cautionCaution

The ASCIIEncoding class does not provide error detection. For security reasons, you should use the UTF8Encoding, UnicodeEncoding, or UTF32Encoding class and enable error detection.

If you choose to use ASCII encoding, this constructor may not provide the appropriate fallback behavior for your application. It uses the EncoderReplacementFallback and DecoderReplacementFallback classes to replace every character outside the range of U+0000 through U+007F with a question mark (?). Instead, you can call the Encoding.GetEncoding(Int32, EncoderFallback, DecoderFallback) or Encoding.GetEncoding(String, EncoderFallback, DecoderFallback) method and pass it EncoderExceptionFallback and DecoderExceptionFallback objects to use exception fallback.

System_CAPS_noteNote

ASCIIEncoding supports only the Unicode character values between U+0000 and U+007F. Therefore, UTF8Encoding, UnicodeEncoding, and UTF32Encoding are better suited for globalized applications.

The following example demonstrates how to create a new ASCIIEncoding instance and display the name of the encoding.

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        ASCIIEncoding ascii = new ASCIIEncoding();
        String encodingName = ascii.EncodingName;
        Console.WriteLine("Encoding name: " + encodingName);
    }
}

Universal Windows Platform
Available since 10
.NET Framework
Available since 1.1
Return to top
Show: