Windows apps
Collapse the table of content
Expand the table of content
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.

ASCIIEncoding Constructor ()

 

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 namespace System;
using namespace System::Text;
int main()
{
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   String^ encodingName = ascii->EncodingName;
   Console::WriteLine( "Encoding name: {0}", encodingName );
}

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