Encoding Klasse

Definition

Namespace:

System.Text

Assembly:

mscorlib.dll

Stellt eine Zeichencodierung dar.

public ref class Encoding abstract : ICloneable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Encoding : ICloneable

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

Public MustInherit Class Encoding
Implements ICloneable

Vererbung

Object

Encoding

Abgeleitet

System.Text.ASCIIEncoding

System.Text.UnicodeEncoding

System.Text.UTF32Encoding

System.Text.UTF7Encoding

System.Text.UTF8Encoding

Attribute

SerializableAttribute ComVisibleAttribute

Implementiert

ICloneable

Beispiele

Im folgenden Beispiel wird eine Zeichenfolge von einer Codierung in eine andere konvertiert.

Note

Das byte[] Array ist der einzige Typ in diesem Beispiel, der die codierten Daten enthält. Die Typen .NET Char und String sind selbst Unicode, sodass die GetChars die Daten zurück in Unicode decodiert.

using System;
using System.Text;

class Example
{
   static void Main()
   {
      string unicodeString = "This string contains the unicode character Pi (\u03a0)";

      // Create two different encodings.
      Encoding ascii = Encoding.ASCII;
      Encoding unicode = Encoding.Unicode;

      // Convert the string into a byte array.
      byte[] unicodeBytes = unicode.GetBytes(unicodeString);

      // Perform the conversion from one encoding to the other.
      byte[] asciiBytes = Encoding.Convert(unicode, ascii, unicodeBytes);
         
      // Convert the new byte[] into a char[] and then into a string.
      char[] asciiChars = new char[ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)];
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0);
      string asciiString = new string(asciiChars);

      // Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString);
      Console.WriteLine("Ascii converted string: {0}", asciiString);
   }
}
// The example displays the following output:
//    Original string: This string contains the unicode character Pi (Π)
//    Ascii converted string: This string contains the unicode character Pi (?)

Imports System.Text

Class Example
   Shared Sub Main()
      Dim unicodeString As String = "This string contains the unicode character Pi (" & ChrW(&H03A0) & ")"

      ' Create two different encodings.
      Dim ascii As Encoding = Encoding.ASCII
      Dim unicode As Encoding = Encoding.Unicode

      ' Convert the string into a byte array.
      Dim unicodeBytes As Byte() = unicode.GetBytes(unicodeString)

      ' Perform the conversion from one encoding to the other.
      Dim asciiBytes As Byte() = Encoding.Convert(unicode, ascii, unicodeBytes)

      ' Convert the new byte array into a char array and then into a string.
      Dim asciiChars(ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)-1) As Char
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0)
      Dim asciiString As New String(asciiChars)

      ' Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString)
      Console.WriteLine("Ascii converted string: {0}", asciiString)
   End Sub
End Class
' The example displays the following output:
'    Original string: This string contains the unicode character Pi (Π)
'    Ascii converted string: This string contains the unicode character Pi (?)

Hinweise

Weitere Informationen zu dieser API finden Sie in den ergänzenden API-Anmerkungen zur Codierung.

Konstruktoren

Name	Beschreibung
Encoding()	Initialisiert eine neue Instanz der Encoding-Klasse.
Encoding(Int32, EncoderFallback, DecoderFallback)	Initialisiert eine neue Instanz der Encoding Klasse, die der angegebenen Codeseite mit den angegebenen Encoder- und Decoderfallbackstrategien entspricht.
Encoding(Int32)	Initialisiert eine neue Instanz der Encoding Klasse, die der angegebenen Codeseite entspricht.

Eigenschaften

Name	Beschreibung
ASCII	Ruft eine Codierung für den ASCII-Zeichensatz (7-Bit) ab.
BigEndianUnicode	Ruft eine Codierung für das UTF-16-Format ab, das die Big Endian Byte-Reihenfolge verwendet.
BodyName	Wenn sie in einer abgeleiteten Klasse überschrieben werden, ruft sie einen Namen für die aktuelle Codierung ab, die mit Nachrichten-Agent-Texttags verwendet werden kann.
CodePage	Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft der Codeseitenbezeichner des aktuellen Encodingab.
DecoderFallback	Dient zum Abrufen oder Festlegen des DecoderFallback Objekts für das aktuelle Encoding Objekt.
Default	Ruft die Standardcodierung für diese .NET-Implementierung ab.
EncoderFallback	Dient zum Abrufen oder Festlegen des EncoderFallback Objekts für das aktuelle Encoding Objekt.
EncodingName	Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft die lesbare Beschreibung der aktuellen Codierung ab.
HeaderName	Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird ein Name für die aktuelle Codierung angezeigt, die mit E-Mail-Agent-Headertags verwendet werden kann.
IsBrowserDisplay	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Wert abgerufen, der angibt, ob die aktuelle Codierung von Browserclients zum Anzeigen von Inhalten verwendet werden kann.
IsBrowserSave	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Wert abgerufen, der angibt, ob die aktuelle Codierung von Browserclients zum Speichern von Inhalten verwendet werden kann.
IsMailNewsDisplay	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Wert abgerufen, der angibt, ob die aktuelle Codierung von E-Mail- und Nachrichtenclients zum Anzeigen von Inhalten verwendet werden kann.
IsMailNewsSave	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert abgerufen, der angibt, ob die aktuelle Codierung von E-Mail- und Nachrichtenclients zum Speichern von Inhalten verwendet werden kann.
IsReadOnly	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert abgerufen, der angibt, ob die aktuelle Codierung schreibgeschützt ist.
IsSingleByte	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Wert abgerufen, der angibt, ob die aktuelle Codierung Single-Byte-Codepunkte verwendet.
Unicode	Ruft eine Codierung für das UTF-16-Format mithilfe der kleinen Endian Bytereihenfolge ab.
UTF32	Ruft eine Codierung für das UTF-32-Format mithilfe der kleinen Endian Bytereihenfolge ab.
UTF7	Ruft eine Codierung für das UTF-7-Format ab.
UTF8	Ruft eine Codierung für das UTF-8-Format ab.
WebName	Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft der Name ab, der bei der Internet Assigned Numbers Authority (IANA) für die aktuelle Codierung registriert ist.
WindowsCodePage	Beim Überschreiben in einer abgeleiteten Klasse ruft die Windows-Betriebssystemcodeseite ab, die der aktuellen Codierung am ehesten entspricht.

Methoden

Name	Beschreibung
Clone()	Wenn eine abgeleitete Klasse überschrieben wird, wird eine flache Kopie des aktuellen Encoding Objekts erstellt.
Convert(Encoding, Encoding, Byte[], Int32, Int32)	Wandelt einen Bytebereich in einem Bytearray von einer Codierung in eine andere um.
Convert(Encoding, Encoding, Byte[])	Konvertiert ein gesamtes Bytearray von einer Codierung in eine andere.
Equals(Object)	Bestimmt, ob die angegebene Object Instanz gleich der aktuellen Instanz ist.
GetByteCount(Char[], Int32, Int32)	Wenn eine abgeleitete Klasse überschrieben wird, wird die Anzahl der Byte berechnet, die durch codieren einer Reihe von Zeichen aus dem angegebenen Zeichenarray erzeugt werden.
GetByteCount(Char[])	Wenn eine abgeleitete Klasse überschrieben wird, wird die Anzahl der Byte berechnet, die durch codieren aller Zeichen im angegebenen Zeichenarray erzeugt werden.
GetByteCount(Char*, Int32)	Wenn eine abgeleitete Klasse überschrieben wird, wird die Anzahl der Bytes berechnet, die durch codieren einer Reihe von Zeichen erstellt werden, die am angegebenen Zeichenzeiger beginnen.
GetByteCount(String)	Wenn eine abgeleitete Klasse überschrieben wird, wird die Anzahl der Byte berechnet, die durch codieren der Zeichen in der angegebenen Zeichenfolge erzeugt werden.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Wenn eine abgeleitete Klasse überschrieben wird, codiert eine Reihe von Zeichen aus dem angegebenen Zeichenarray in das angegebene Bytearray.
GetBytes(Char[], Int32, Int32)	Wenn eine abgeleitete Klasse überschrieben wird, codiert eine Reihe von Zeichen aus dem angegebenen Zeichenarray in eine Folge von Bytes.
GetBytes(Char[])	Wenn sie in einer abgeleiteten Klasse überschrieben wird, werden alle Zeichen im angegebenen Zeichenarray in eine Folge von Bytes codiert.
GetBytes(Char*, Int32, Byte*, Int32)	Wenn eine abgeleitete Klasse überschrieben wird, codiert eine Reihe von Zeichen, die am angegebenen Zeichenzeiger beginnen, in eine Abfolge von Bytes, die ab dem angegebenen Bytezeiger gespeichert werden.
GetBytes(String, Int32, Int32, Byte[], Int32)	Wenn eine abgeleitete Klasse überschrieben wird, codiert eine Reihe von Zeichen aus der angegebenen Zeichenfolge in das angegebene Bytearray.
GetBytes(String)	Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, codiert sie alle Zeichen in der angegebenen Zeichenfolge in eine Folge von Bytes.
GetCharCount(Byte[], Int32, Int32)	Wenn eine abgeleitete Klasse überschrieben wird, wird die Anzahl der Zeichen berechnet, die durch Decodieren einer Bytesequenz aus dem angegebenen Bytearray erzeugt werden.
GetCharCount(Byte[])	Wenn eine abgeleitete Klasse überschrieben wird, wird die Anzahl der Zeichen berechnet, die durch Decodieren aller Bytes im angegebenen Bytearray erzeugt werden.
GetCharCount(Byte*, Int32)	Wenn eine abgeleitete Klasse überschrieben wird, wird die Anzahl der Zeichen berechnet, die durch Decodieren einer Bytesequenz erzeugt werden, beginnend mit dem angegebenen Bytezeiger.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Wenn eine abgeleitete Klasse überschrieben wird, decodiert eine Bytesequenz aus dem angegebenen Bytearray in das angegebene Zeichenarray.
GetChars(Byte[], Int32, Int32)	Wenn eine abgeleitete Klasse überschrieben wird, decodiert eine Bytesequenz aus dem angegebenen Bytearray in eine Reihe von Zeichen.
GetChars(Byte[])	Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, decodieren Sie alle Bytes im angegebenen Bytearray in eine Reihe von Zeichen.
GetChars(Byte*, Int32, Char*, Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben werden, decodieren Sie eine Bytesequenz ab dem angegebenen Bytezeiger in eine Reihe von Zeichen, die ab dem angegebenen Zeichenzeiger gespeichert werden.
GetDecoder()	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Decoder abgerufen, der eine codierte Bytesequenz in eine Abfolge von Zeichen konvertiert.
GetEncoder()	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Encoder abgerufen, der eine Sequenz von Unicode-Zeichen in eine codierte Bytesequenz konvertiert.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Gibt die Codierung zurück, die dem angegebenen Codeseitenbezeichner zugeordnet ist. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und Bytesequenzen, die nicht decodiert werden können.
GetEncoding(Int32)	Gibt die Codierung zurück, die dem angegebenen Codeseitenbezeichner zugeordnet ist.
GetEncoding(String, EncoderFallback, DecoderFallback)	Gibt die Codierung zurück, die dem angegebenen Codeseitennamen zugeordnet ist. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und Bytesequenzen, die nicht decodiert werden können.
GetEncoding(String)	Gibt die Codierung zurück, die dem angegebenen Codeseitennamen zugeordnet ist.
GetEncodings()	Gibt ein Array zurück, das alle Codierungen enthält.
GetHashCode()	Gibt den Hashcode für die aktuelle Instanz zurück.
GetMaxByteCount(Int32)	Wenn eine abgeleitete Klasse überschrieben wird, wird die maximale Anzahl von Byte berechnet, die durch codieren der angegebenen Anzahl von Zeichen erzeugt werden.
GetMaxCharCount(Int32)	Wenn eine abgeleitete Klasse überschrieben wird, wird die maximale Anzahl von Zeichen berechnet, die durch Decodieren der angegebenen Anzahl von Bytes erzeugt werden.
GetPreamble()	Wenn eine abgeleitete Klasse überschrieben wird, wird eine Bytesequenz zurückgegeben, die die verwendete Codierung angibt.
GetString(Byte[], Int32, Int32)	Wenn eine abgeleitete Klasse überschrieben wird, decodiert eine Bytesequenz aus dem angegebenen Bytearray in eine Zeichenfolge.
GetString(Byte[])	Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, decodieren Sie alle Bytes im angegebenen Bytearray in eine Zeichenfolge.
GetString(Byte*, Int32)	Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, decodieren Sie eine angegebene Anzahl von Bytes beginnend mit einer angegebenen Adresse in eine Zeichenfolge.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IsAlwaysNormalized()	Ruft einen Wert ab, der angibt, ob die aktuelle Codierung immer normalisiert ist, mithilfe des Standardnormalisierungsformulars.
IsAlwaysNormalized(NormalizationForm)	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Wert abgerufen, der angibt, ob die aktuelle Codierung immer normalisiert ist, mithilfe des angegebenen Normalisierungsformulars.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
RegisterProvider(EncodingProvider)	Registriert einen Codierungsanbieter.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Verwenden von Zeichencodierungsklassen in .NET