Encoding Klasa

Definicja

Przestrzeń nazw:

System.Text

Zestaw:

mscorlib.dll

Reprezentuje kodowanie znaków.

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

Dziedziczenie

Object

Encoding

Pochodne

System.Text.ASCIIEncoding

System.Text.UnicodeEncoding

System.Text.UTF32Encoding

System.Text.UTF7Encoding

System.Text.UTF8Encoding

Atrybuty

SerializableAttribute ComVisibleAttribute

Implementuje

ICloneable

Przykłady

Poniższy przykład konwertuje ciąg z jednego kodowania na inny.

Uwaga / Notatka

Tablica byte[] jest jedynym typem w tym przykładzie, który zawiera zakodowane dane. Typy .NET Char i String są samymi standardami Unicode, więc wywołanie GetChars dekoduje dane z powrotem do 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 (?)

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dotyczące kodowania.

Konstruktory

Nazwa	Opis
Encoding()	Inicjuje nowe wystąpienie klasy Encoding.
Encoding(Int32, EncoderFallback, DecoderFallback)	Inicjuje nowe wystąpienie Encoding klasy odpowiadające określonej stronie kodu za pomocą określonych strategii rezerwowych kodera i dekodera.
Encoding(Int32)	Inicjuje nowe wystąpienie Encoding klasy odpowiadające określonej stronie kodu.

Właściwości

Nazwa	Opis
ASCII	Pobiera kodowanie zestawu znaków ASCII (7-bitowe).
BigEndianUnicode	Pobiera kodowanie dla formatu UTF-16, który używa kolejności bajtów big endian.
BodyName	Po zastąpieniu w klasie pochodnej pobiera nazwę bieżącego kodowania, które może być używane z tagami treści agenta poczty.
CodePage	Po przesłonięciu w klasie pochodnej pobiera identyfikator strony kodowej bieżącego Encodingelementu .
DecoderFallback	Pobiera lub ustawia DecoderFallback obiekt dla bieżącego Encoding obiektu.
Default	Pobiera domyślne kodowanie dla tej implementacji platformy .NET.
EncoderFallback	Pobiera lub ustawia EncoderFallback obiekt dla bieżącego Encoding obiektu.
EncodingName	Po zastąpieniu w klasie pochodnej pobiera czytelny dla człowieka opis bieżącego kodowania.
HeaderName	Po zastąpieniu w klasie pochodnej pobiera nazwę bieżącego kodowania, którego można używać z tagami nagłówka agenta poczty.
IsBrowserDisplay	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów przeglądarki do wyświetlania zawartości.
IsBrowserSave	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów przeglądarki do zapisywania zawartości.
IsMailNewsDisplay	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów poczty i wiadomości do wyświetlania zawartości.
IsMailNewsSave	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie może być używane przez klientów poczty i wiadomości do zapisywania zawartości.
IsReadOnly	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie jest tylko do odczytu.
IsSingleByte	Po przesłonięciu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie używa punktów kodu jedno bajtów.
Unicode	Pobiera kodowanie dla formatu UTF-16 przy użyciu małej kolejności bajtów endian.
UTF32	Pobiera kodowanie dla formatu UTF-32 przy użyciu małej kolejności bajtów endian.
UTF7	Pobiera kodowanie dla formatu UTF-7.
UTF8	Pobiera kodowanie dla formatu UTF-8.
WebName	Po zastąpieniu w klasie pochodnej pobiera nazwę zarejestrowaną w urzędzie IANA (Internet Assigned Numbers Authority) dla bieżącego kodowania.
WindowsCodePage	Po zastąpieniu w klasie pochodnej pobiera stronę kodową systemu operacyjnego Windows, która najbardziej odpowiada bieżącemu kodowaniu.

Metody

Nazwa	Opis
Clone()	Po zastąpieniu w klasie pochodnej tworzy płytkią kopię bieżącego Encoding obiektu.
Convert(Encoding, Encoding, Byte[], Int32, Int32)	Konwertuje zakres bajtów w tablicy bajtów z jednego kodowania na inny.
Convert(Encoding, Encoding, Byte[])	Konwertuje całą tablicę bajtów z jednego kodowania na inny.
Equals(Object)	Określa, czy określona Object wartość jest równa bieżącemu wystąpieniu.
GetByteCount(Char[], Int32, Int32)	Po zastąpieniu w klasie pochodnej oblicza liczbę bajtów generowanych przez kodowanie zestawu znaków z określonej tablicy znaków.
GetByteCount(Char[])	Po zastąpieniu w klasie pochodnej oblicza liczbę bajtów generowanych przez kodowanie wszystkich znaków w określonej tablicy znaków.
GetByteCount(Char*, Int32)	Po zastąpieniu w klasie pochodnej oblicza liczbę bajtów generowanych przez kodowanie zestawu znaków rozpoczynających się od określonego wskaźnika znaków.
GetByteCount(String)	Po zastąpieniu w klasie pochodnej oblicza liczbę bajtów generowanych przez kodowanie znaków w określonym ciągu.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Po zastąpieniu w klasie pochodnej koduje zestaw znaków z określonej tablicy znaków do określonej tablicy bajtów.
GetBytes(Char[], Int32, Int32)	Po zastąpieniu w klasie pochodnej koduje zestaw znaków z określonej tablicy znaków do sekwencji bajtów.
GetBytes(Char[])	Po zastąpieniu w klasie pochodnej koduje wszystkie znaki w określonej tablicy znaków w sekwencji bajtów.
GetBytes(Char*, Int32, Byte*, Int32)	Po przesłonięciu w klasie pochodnej koduje zestaw znaków rozpoczynający się od określonego wskaźnika znaku do sekwencji bajtów przechowywanych od określonego wskaźnika bajtów.
GetBytes(String, Int32, Int32, Byte[], Int32)	Po zastąpieniu w klasie pochodnej koduje zestaw znaków z określonego ciągu do określonej tablicy bajtów.
GetBytes(String)	Po zastąpieniu w klasie pochodnej koduje wszystkie znaki w określonym ciągu w sekwencji bajtów.
GetCharCount(Byte[], Int32, Int32)	Po zastąpieniu w klasie pochodnej oblicza liczbę znaków generowanych przez dekodowanie sekwencji bajtów z określonej tablicy bajtów.
GetCharCount(Byte[])	Po zastąpieniu w klasie pochodnej oblicza liczbę znaków generowanych przez dekodowanie wszystkich bajtów w określonej tablicy bajtów.
GetCharCount(Byte*, Int32)	Podczas zastępowania w klasie pochodnej oblicza liczbę znaków generowanych przez dekodowanie sekwencji bajtów rozpoczynających się od określonego wskaźnika bajtów.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Po zastąpieniu w klasie pochodnej dekoduje sekwencję bajtów z określonej tablicy bajtów do określonej tablicy znaków.
GetChars(Byte[], Int32, Int32)	Po zastąpieniu w klasie pochodnej dekoduje sekwencję bajtów z określonej tablicy bajtów do zestawu znaków.
GetChars(Byte[])	Po zastąpieniu w klasie pochodnej dekoduje wszystkie bajty w określonej tablicy bajtów do zestawu znaków.
GetChars(Byte*, Int32, Char*, Int32)	Gdy przesłonięta w klasie pochodnej, dekoduje sekwencję bajtów rozpoczynającą się od określonego wskaźnika bajtów do zestawu znaków, które są przechowywane począwszy od określonego wskaźnika znaków.
GetDecoder()	Po zastąpieniu klasy pochodnej uzyskuje dekoder, który konwertuje zakodowaną sekwencję bajtów na sekwencję znaków.
GetEncoder()	Po zastąpieniu w klasie pochodnej uzyskuje koder, który konwertuje sekwencję znaków Unicode na zakodowaną sekwencję bajtów.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Zwraca kodowanie skojarzone z określonym identyfikatorem strony kodowej. Parametry określają procedurę obsługi błędów dla znaków, których nie można kodować i sekwencje bajtów, których nie można zdekodować.
GetEncoding(Int32)	Zwraca kodowanie skojarzone z określonym identyfikatorem strony kodowej.
GetEncoding(String, EncoderFallback, DecoderFallback)	Zwraca kodowanie skojarzone z określoną nazwą strony kodowej. Parametry określają procedurę obsługi błędów dla znaków, których nie można kodować i sekwencje bajtów, których nie można zdekodować.
GetEncoding(String)	Zwraca kodowanie skojarzone z określoną nazwą strony kodowej.
GetEncodings()	Zwraca tablicę zawierającą wszystkie kodowanie.
GetHashCode()	Zwraca kod skrótu dla bieżącego wystąpienia.
GetMaxByteCount(Int32)	Po zastąpieniu w klasie pochodnej oblicza maksymalną liczbę bajtów generowanych przez kodowanie określonej liczby znaków.
GetMaxCharCount(Int32)	Podczas zastępowania w klasie pochodnej oblicza maksymalną liczbę znaków generowanych przez dekodowanie określonej liczby bajtów.
GetPreamble()	Po zastąpieniu w klasie pochodnej zwraca sekwencję bajtów, która określa użyte kodowanie.
GetString(Byte[], Int32, Int32)	Po zastąpieniu w klasie pochodnej dekoduje sekwencję bajtów z określonej tablicy bajtów do ciągu.
GetString(Byte[])	Po zastąpieniu w klasie pochodnej dekoduje wszystkie bajty w określonej tablicy bajtów do ciągu.
GetString(Byte*, Int32)	Po zastąpieniu w klasie pochodnej dekoduje określoną liczbę bajtów rozpoczynających się od określonego adresu do ciągu.
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
IsAlwaysNormalized()	Pobiera wartość wskazującą, czy bieżące kodowanie jest zawsze znormalizowane przy użyciu domyślnego formularza normalizacji.
IsAlwaysNormalized(NormalizationForm)	Po zastąpieniu w klasie pochodnej pobiera wartość wskazującą, czy bieżące kodowanie jest zawsze znormalizowane przy użyciu określonej formy normalizacji.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
RegisterProvider(EncodingProvider)	Rejestruje dostawcę kodowania.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Jak używać klas kodowania znaków na platformie .NET