Encoding Klas

Definitie

Naamruimte:

System.Text

Assembly:

mscorlib.dll

Vertegenwoordigt een tekencodering.

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

Overname

Object

Encoding

Afgeleid

System.Text.ASCIIEncoding

System.Text.UnicodeEncoding

System.Text.UTF32Encoding

System.Text.UTF7Encoding

System.Text.UTF8Encoding

Kenmerken

SerializableAttribute ComVisibleAttribute

Implementeringen

ICloneable

Voorbeelden

In het volgende voorbeeld wordt een tekenreeks geconverteerd van de ene codering naar de andere.

Note

De byte[] matrix is het enige type in dit voorbeeld dat de gecodeerde gegevens bevat. De typen .NET Char en String zijn zelf Unicode, dus de GetChars roept de gegevens terug naar Unicode.

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 (?)

Opmerkingen

Zie Aanvullende API-opmerkingen voor codering voor meer informatie over deze API.

Constructors

Name	Description
Encoding()	Initialiseert een nieuw exemplaar van de Encoding klasse.
Encoding(Int32, EncoderFallback, DecoderFallback)	Initialiseert een nieuw exemplaar van de Encoding klasse die overeenkomt met de opgegeven codepagina met de opgegeven coderingsprogramma- en decodertervalstrategieën.
Encoding(Int32)	Initialiseert een nieuw exemplaar van de Encoding klasse die overeenkomt met de opgegeven codepagina.

Eigenschappen

Name	Description
ASCII	Hiermee haalt u een codering op voor de ASCII-tekenset (7-bits).
BigEndianUnicode	Hiermee haalt u een codering op voor de UTF-16-indeling die gebruikmaakt van de big endian bytevolgorde.
BodyName	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een naam voor de huidige codering die kan worden gebruikt met hoofdtags van de e-mailagent.
CodePage	Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de codepagina-id van de huidige Encodingop.
DecoderFallback	Hiermee wordt het DecoderFallback object voor het huidige Encoding object opgehaald of ingesteld.
Default	Hiermee haalt u de standaardcodering voor deze .NET-implementatie op.
EncoderFallback	Hiermee wordt het EncoderFallback object voor het huidige Encoding object opgehaald of ingesteld.
EncodingName	Wanneer deze wordt overschreven in een afgeleide klasse, wordt de leesbare beschrijving van de huidige codering opgehaald.
HeaderName	Wanneer deze worden overschreven in een afgeleide klasse, krijgt u een naam voor de huidige codering die kan worden gebruikt met headertags van de e-mailagent.
IsBrowserDisplay	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door browserclients om inhoud weer te geven.
IsBrowserSave	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door browserclients voor het opslaan van inhoud.
IsMailNewsDisplay	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door mail- en nieuwsclients om inhoud weer te geven.
IsMailNewsSave	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door e-mail- en nieuwsclients om inhoud op te slaan.
IsReadOnly	Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde opgehaald die aangeeft of de huidige codering het kenmerk Alleen-lezen heeft.
IsSingleByte	Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde opgehaald die aangeeft of de huidige codering gebruikmaakt van codepunten met één byte.
Unicode	Hiermee haalt u een codering op voor de UTF-16-indeling met behulp van de bytevolgorde little endian.
UTF32	Hiermee haalt u een codering op voor de UTF-32-indeling met behulp van de bytevolgorde little endian.
UTF7	Hiermee haalt u een codering op voor de UTF-7-indeling.
UTF8	Hiermee haalt u een codering op voor de UTF-8-indeling.
WebName	Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de naam op die is geregistreerd bij de Internet Assigned Numbers Authority (IANA) voor de huidige codering.
WindowsCodePage	Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de Windows codepagina van het besturingssysteem op die het meest overeenkomt met de huidige codering.

Methoden

Name	Description
Clone()	Wanneer deze wordt overschreven in een afgeleide klasse, maakt u een ondiepe kopie van het huidige Encoding object.
Convert(Encoding, Encoding, Byte[], Int32, Int32)	Converteert een bereik van bytes in een bytematrix van de ene codering naar de andere.
Convert(Encoding, Encoding, Byte[])	Converteert een hele bytematrix van de ene codering naar de andere.
Equals(Object)	Bepaalt of de opgegeven Object waarde gelijk is aan het huidige exemplaar.
GetByteCount(Char[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door een set tekens van de opgegeven tekenmatrix te coderen.
GetByteCount(Char[])	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door alle tekens in de opgegeven tekenmatrix te coderen.
GetByteCount(Char*, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door een set tekens te coderen die beginnen bij de opgegeven tekenwijzer.
GetByteCount(String)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door de tekens in de opgegeven tekenreeks te coderen.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u een set tekens van de opgegeven tekenmatrix in de opgegeven bytematrix.
GetBytes(Char[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u een set tekens van de opgegeven tekenmatrix in een reeks bytes.
GetBytes(Char[])	Wanneer deze worden overschreven in een afgeleide klasse, codeert u alle tekens in de opgegeven tekenmatrix in een reeks bytes.
GetBytes(Char*, Int32, Byte*, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u een reeks tekens die beginnen bij de opgegeven tekenwijzer in een reeks bytes die zijn opgeslagen vanaf de opgegeven byte-aanwijzer.
GetBytes(String, Int32, Int32, Byte[], Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u een set tekens van de opgegeven tekenreeks in de opgegeven bytematrix.
GetBytes(String)	Wanneer deze worden overschreven in een afgeleide klasse, codeert u alle tekens in de opgegeven tekenreeks in een reeks bytes.
GetCharCount(Byte[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes van de opgegeven bytematrix.
GetCharCount(Byte[])	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door alle bytes in de opgegeven bytematrix te decoderen.
GetCharCount(Byte*, Int32)	Wanneer deze worden overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door een reeks bytes te decoderen die beginnen bij de opgegeven byteaanwijzer.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u een reeks bytes van de opgegeven bytematrix in de opgegeven tekenmatrix.
GetChars(Byte[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u een reeks bytes van de opgegeven bytematrix in een reeks tekens.
GetChars(Byte[])	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u alle bytes in de opgegeven bytematrix in een set tekens.
GetChars(Byte*, Int32, Char*, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u een reeks bytes die beginnen bij de opgegeven byteaanwijzer in een set tekens die zijn opgeslagen vanaf de opgegeven tekenaanwijzer.
GetDecoder()	Wanneer deze wordt overschreven in een afgeleide klasse, verkrijgt u een decoder waarmee een gecodeerde reeks bytes wordt geconverteerd naar een reeks tekens.
GetEncoder()	Wanneer deze wordt overschreven in een afgeleide klasse, verkrijgt u een encoder waarmee een reeks Unicode-tekens wordt geconverteerd naar een gecodeerde reeks bytes.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Retourneert de codering die is gekoppeld aan de opgegeven codepagina-id. Parameters geven een fouthandler op voor tekens die niet kunnen worden gecodeerd en bytereeksen die niet kunnen worden gedecodeerd.
GetEncoding(Int32)	Retourneert de codering die is gekoppeld aan de opgegeven codepagina-id.
GetEncoding(String, EncoderFallback, DecoderFallback)	Retourneert de codering die is gekoppeld aan de opgegeven codepaginanaam. Parameters geven een fouthandler op voor tekens die niet kunnen worden gecodeerd en bytereeksen die niet kunnen worden gedecodeerd.
GetEncoding(String)	Retourneert de codering die is gekoppeld aan de opgegeven codepaginanaam.
GetEncodings()	Retourneert een matrix die alle coderingen bevat.
GetHashCode()	Retourneert de hash-code voor het huidige exemplaar.
GetMaxByteCount(Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het maximum aantal bytes dat wordt geproduceerd door het opgegeven aantal tekens te coderen.
GetMaxCharCount(Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het maximum aantal tekens dat wordt geproduceerd door het opgegeven aantal bytes te decoderen.
GetPreamble()	Wanneer deze wordt overschreven in een afgeleide klasse, retourneert u een reeks bytes die de gebruikte codering aangeeft.
GetString(Byte[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u een reeks bytes van de opgegeven bytematrix in een tekenreeks.
GetString(Byte[])	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u alle bytes in de opgegeven bytematrix in een tekenreeks.
GetString(Byte*, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u een opgegeven aantal bytes dat begint bij een opgegeven adres in een tekenreeks.
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
IsAlwaysNormalized()	Hiermee wordt een waarde opgehaald die aangeeft of de huidige codering altijd is genormaliseerd, met behulp van de standaardnormalisatievorm.
IsAlwaysNormalized(NormalizationForm)	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering altijd is genormaliseerd, met behulp van de opgegeven normalisatievorm.
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
RegisterProvider(EncodingProvider)	Registreert een coderingsprovider.
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Zie ook

• Hoe u tekencoderingsklassen gebruikt in .NET