Encoding Sınıf

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

mscorlib.dll

Karakter kodlamayı temsil eder.

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

Devralma

Object

Encoding

Türetilmiş

System.Text.ASCIIEncoding

System.Text.UnicodeEncoding

System.Text.UTF32Encoding

System.Text.UTF7Encoding

System.Text.UTF8Encoding

Öznitelikler

SerializableAttribute ComVisibleAttribute

Uygulamalar

ICloneable

Örnekler

Aşağıdaki örnek bir dizeyi bir kodlamadan diğerine dönüştürür.

Note

Dizi byte[] , bu örnekte kodlanmış verileri içeren tek türdür. .NET Char ve String türleri kendileri Unicode olduğundan GetChars çağrısı verilerin kodunu Unicode'a geri çözer.

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

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz. Kodlama için ek API açıklamaları.

Oluşturucular

Name	Description
Encoding()	Encoding sınıfının yeni bir örneğini başlatır.
Encoding(Int32, EncoderFallback, DecoderFallback)	Belirtilen kodlayıcı ve kod çözücü geri dönüş stratejileriyle belirtilen kod sayfasına karşılık gelen sınıfın yeni bir örneğini Encoding başlatır.
Encoding(Int32)	Sınıfın Encoding belirtilen kod sayfasına karşılık gelen yeni bir örneğini başlatır.

Özellikler

Name	Description
ASCII	ASCII (7 bit) karakter kümesi için bir kodlama alır.
BigEndianUnicode	UtF-16 biçimi için büyük endian bayt sırasını kullanan bir kodlama alır.
BodyName	Türetilmiş bir sınıfta geçersiz kılındığında, posta aracısı gövde etiketleriyle kullanılabilen geçerli kodlama için bir ad alır.
CodePage	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli Encodingöğesinin kod sayfası tanımlayıcısını alır.
DecoderFallback	Geçerli DecoderFallback nesnenin Encoding nesnesini alır veya ayarlar.
Default	Bu .NET uygulaması için varsayılan kodlamayı alır.
EncoderFallback	Geçerli EncoderFallback nesnenin Encoding nesnesini alır veya ayarlar.
EncodingName	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın okunabilir açıklamasını alır.
HeaderName	Türetilmiş bir sınıfta geçersiz kılındığında, posta aracısı üst bilgi etiketleriyle kullanılabilecek geçerli kodlama için bir ad alır.
IsBrowserDisplay	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın tarayıcı istemcileri tarafından içeriği görüntülemek için kullanılıp kullanılamayacağını belirten bir değer alır.
IsBrowserSave	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın içeriği kaydetmek için tarayıcı istemcileri tarafından kullanılıp kullanılamayacağını belirten bir değer alır.
IsMailNewsDisplay	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın posta ve haber istemcileri tarafından içerik görüntülemek için kullanılıp kullanılamayacağını belirten bir değer alır.
IsMailNewsSave	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın içeriği kaydetmek için posta ve haber istemcileri tarafından kullanılıp kullanılamayacağını belirten bir değer alır.
IsReadOnly	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın salt okunur olup olmadığını belirten bir değer alır.
IsSingleByte	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın tek bayt kod noktaları kullanıp kullanmadığını belirten bir değer alır.
Unicode	Küçük endian bayt sırasını kullanarak UTF-16 biçimi için bir kodlama alır.
UTF32	Küçük endian bayt sırasını kullanarak UTF-32 biçimi için bir kodlama alır.
UTF7	UTF-7 biçimi için bir kodlama alır.
UTF8	UTF-8 biçimi için bir kodlama alır.
WebName	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlama için İnternet Atanan Numaralar Yetkilisi'ne (IANA) kaydedilen adı alır.
WindowsCodePage	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamaya en yakın olan Windows işletim sistemi kodu sayfasını alır.

Yöntemler

Name	Description
Clone()	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli Encoding nesnenin sığ bir kopyasını oluşturur.
Convert(Encoding, Encoding, Byte[], Int32, Int32)	Bayt dizisindeki bayt aralığını bir kodlamadan diğerine dönüştürür.
Convert(Encoding, Encoding, Byte[])	Bayt dizisinin tamamını bir kodlamadan diğerine dönüştürür.
Equals(Object)	Belirtilen Object değerin geçerli örneğe eşit olup olmadığını belirler.
GetByteCount(Char[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisinden bir karakter kümesi kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(Char[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(Char*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter işaretçisinde başlayan bir karakter kümesini kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki karakterleri kodlayarak üretilen bayt sayısını hesaplar.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki bir karakter kümesini belirtilen bayt dizisine kodlar.
GetBytes(Char[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki bir karakter kümesini bayt dizisine kodlar.
GetBytes(Char[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri bayt dizisine kodlar.
GetBytes(Char*, Int32, Byte*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter işaretçisinde başlayan bir karakter kümesini belirtilen bayt işaretçisinde başlayan bir bayt dizisine kodlar.
GetBytes(String, Int32, Int32, Byte[], Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki bir karakter kümesini belirtilen bayt dizisine kodlar.
GetBytes(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki tüm karakterleri bir bayt dizisine kodlar.
GetCharCount(Byte[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisinden bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(Byte*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt işaretçisinde başlayan bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bayt dizisinin kodunu belirtilen karakter dizisine çözer.
GetChars(Byte[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bayt dizisinin kodunu bir karakter kümesine çözer.
GetChars(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu bir karakter kümesine çözer.
GetChars(Byte*, Int32, Char*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt işaretçisinde başlayan bir bayt dizisinin kodunu, belirtilen karakter işaretçisinde başlayan bir dizi karaktere dönüştürür.
GetDecoder()	Türetilmiş bir sınıfta geçersiz kılındığında, kodlanmış bayt dizisini bir karakter dizisine dönüştüren bir kod çözücü alır.
GetEncoder()	Türetilmiş bir sınıfta geçersiz kılındığında, Unicode karakter dizisini kodlanmış bayt dizisine dönüştüren bir kodlayıcı alır.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Belirtilen kod sayfası tanımlayıcısıyla ilişkili kodlamayı döndürür. Parametreler, kodlanamayan karakterler için bir hata işleyicisi ve kodu çözülemeyen bayt dizileri belirtir.
GetEncoding(Int32)	Belirtilen kod sayfası tanımlayıcısıyla ilişkili kodlamayı döndürür.
GetEncoding(String, EncoderFallback, DecoderFallback)	Belirtilen kod sayfası adıyla ilişkili kodlamayı döndürür. Parametreler, kodlanamayan karakterler için bir hata işleyicisi ve kodu çözülemeyen bayt dizileri belirtir.
GetEncoding(String)	Belirtilen kod sayfası adıyla ilişkili kodlamayı döndürür.
GetEncodings()	Tüm kodlamaları içeren bir dizi döndürür.
GetHashCode()	Geçerli örneğin karma kodunu döndürür.
GetMaxByteCount(Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter sayısını kodlayarak üretilen en fazla bayt sayısını hesaplar.
GetMaxCharCount(Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt sayısının kodunu çözerek üretilen en fazla karakter sayısını hesaplar.
GetPreamble()	Türetilmiş bir sınıfta geçersiz kılındığında, kullanılan kodlamayı belirten bir bayt dizisi döndürür.
GetString(Byte[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bir bayt dizisinin kodunu bir dizeye çözer.
GetString(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu bir dizeye çözer.
GetString(Byte*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bir adresten başlayan belirtilen sayıda bayt kodunu bir dizeye çözer.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsAlwaysNormalized()	Varsayılan normalleştirme formunu kullanarak geçerli kodlamanın her zaman normalleştirilip normalleştirilmediğini belirten bir değer alır.
IsAlwaysNormalized(NormalizationForm)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen normalleştirme formunu kullanarak geçerli kodlamanın her zaman normalleştirilip normalleştirilmediğini belirten bir değer alır.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
RegisterProvider(EncodingProvider)	Bir kodlama sağlayıcısı kaydeder.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• .NET'te karakter kodlama sınıflarını kullanma