ASCIIEncoding Konstruktor

Definicja

Przestrzeń nazw:

System.Text

Zestawy:

mscorlib.dll, System.Text.Encoding.Extensions.dll

Zestaw:

System.Text.Encoding.Extensions.dll

Zestaw:

mscorlib.dll

Zestaw:

netstandard.dll

Inicjuje nowe wystąpienie klasy ASCIIEncoding.

public:
 ASCIIEncoding();

public ASCIIEncoding ();

Public Sub New ()

Przykłady

W poniższym przykładzie pokazano, jak utworzyć nowe ASCIIEncoding wystąpienie i wyświetlić nazwę kodowania.

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

using System;
using System.Text;

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

Imports System.Text

Class ASCIIEncodingExample   
    Public Shared Sub Main()
        Dim ascii As New ASCIIEncoding()
        Dim encodingName As String = ascii.EncodingName
        Console.WriteLine("Encoding name: " & encodingName)
    End Sub
End Class

Uwagi

Przestroga

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

Jeśli zdecydujesz się używać kodowania ASCII, ten konstruktor może nie zapewnić odpowiedniego zachowania rezerwowego dla aplikacji. Używa EncoderReplacementFallback klas i DecoderReplacementFallback , aby zastąpić każdy znak poza zakresem U+0000 do U+007F znakiem zapytania (?). Zamiast tego można wywołać metodę Encoding.GetEncoding(Int32, EncoderFallback, DecoderFallback) or Encoding.GetEncoding(String, EncoderFallback, DecoderFallback) i przekazać ją EncoderExceptionFallback i DecoderExceptionFallback obiekty, aby użyć rezerwowego wyjątku.

Uwaga

ASCIIEncoding obsługuje tylko wartości znaków Unicode z zakresu od U+0000 do U+007F. W związku z tym , UTF8EncodingUnicodeEncodingi UTF32Encoding są lepiej dostosowane do aplikacji zglobalizowanej.