Encoding Sınıf

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Encoding.cs

Karakter kodlamayı temsil eder.

public ref class Encoding abstract : ICloneable

public abstract class Encoding : ICloneable

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

Uygulamalar

ICloneable

Örnekler

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

Not

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

using namespace System;
using namespace System::Text;

int 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.
   array<Byte>^unicodeBytes = unicode->GetBytes( unicodeString );
   
   // Perform the conversion from one encoding to the other.
   array<Byte>^asciiBytes = Encoding::Convert( unicode, ascii, unicodeBytes );
   
   // Convert the new Byte into[] a char and[] then into a string.
   array<Char>^asciiChars = gcnew array<Char>(ascii->GetCharCount( asciiBytes, 0, asciiBytes->Length ));
   ascii->GetChars( asciiBytes, 0, asciiBytes->Length, asciiChars, 0 );
   String^ asciiString = gcnew 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 (?)

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

Encoding()	Encoding sınıfının yeni bir örneğini başlatır.
Encoding(Int32)	Belirtilen kod sayfasına karşılık gelen sınıfının yeni bir örneğini Encoding 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ın yeni bir örneğini Encoding başlatır.

Özellikler

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ılabilecek 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 Encoding nesnenin DecoderFallback nesnesini alır veya ayarlar.
Default	Bu .NET uygulaması için varsayılan kodlamayı alır.
EncoderFallback	Geçerli Encoding nesnenin EncoderFallback nesnesini alır veya ayarlar.
EncodingName	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın insan tarafından 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 içeriği görüntülemek için tarayıcı istemcileri tarafından 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çeriği 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 baytlık kod noktaları kullanıp kullanmadığını belirten bir değer alır.
Latin1	Latin1 karakter kümesi (ISO-8859-1) için bir kodlama alır.
Preamble	Türetilmiş bir sınıfta geçersiz kılındığında, kullanılan kodlamayı belirten bayt sırasını içeren bir yayma döndürü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	Geçersiz. 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 Tarafından 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 kod sayfasını alır.

Yöntemler

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[])	Bir bayt dizisinin tamamını bir kodlamadan diğerine dönüştürür.
Convert(Encoding, Encoding, Byte[], Int32, Int32)	Bayt dizisindeki bayt aralığını bir kodlamadan diğerine dönüştürür.
CreateTranscodingStream(Stream, Encoding, Encoding, Boolean)	Stream bir iç Encoding ile dış Encodingarasında verileri kodlamaya hizmet eden bir oluşturur. Buna benzer.Convert(Encoding, Encoding, Byte[])
Equals(Object)	Belirtilen Object değerin geçerli örneğe eşit olup olmadığını belirler.
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(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, 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(ReadOnlySpan<Char>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter aralığındaki karakterleri 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.
GetByteCount(String, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizeden bir karakter kümesi kodlayarak üretilen bayt sayısını hesaplar.
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(Char[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri bir 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[], 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(ReadOnlySpan<Char>, Span<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen salt okunur yayılma alanından bir dizi karakter bayt aralığına kodlar.
GetBytes(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki tüm karakterleri bir bayt dizisine kodlar.
GetBytes(String, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizede tarafından count belirtilen karakter sayısını belirtilenden başlayarak bayt dizisine indexkodlar.
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.
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.
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, 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(ReadOnlySpan<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, sağlanan salt okunur bayt aralığının kodunu çözerek üretilen karakter sayısını hesaplar.
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 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, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bir bayt dizisinin kodunu bir karakter kümesine çözer.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bir bayt dizisinin kodunu belirtilen karakter dizisine çözer.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen salt okunur bayt aralığındaki tüm baytların kodunu bir karakter aralığına çözer.
GetDecoder()	Türetilmiş bir sınıfta geçersiz kılındığında, kodlanmış bir 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)	Belirtilen kod sayfası tanımlayıcısıyla ilişkili kodlamayı döndürü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(String)	Belirtilen kod sayfası adı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.
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)	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.
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, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bir bayt dizisinin kodunu bir dizeye çözer.
GetString(ReadOnlySpan<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt aralığındaki tüm baytların kodunu bir dizeye çözer.
GetType()	Type Geçerli örneğini 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 Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
RegisterProvider(EncodingProvider)	Bir kodlama sağlayıcısı kaydeder.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Hedef yeterince büyükse, belirtilen salt okunur span'dan bir dizi karakter bayt aralığına kodlar.
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Hedef yeterince büyükse, belirtilen salt okunur span'dan bir dizi bayt karakterine kod çözer.

Uzantı Metotları

GetBytes(Encoding, ReadOnlySequence<Char>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak bir Byte diziye Encodingkodlar.
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Belirtilen ReadOnlySequence<T>byteöğesini kullanarak öğesinin kodunu s olarak Encoding çözer ve sonucu öğesine writeryazar.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak Encoding öğesini olarak bytekodlar ve sonucu olarak bytesdöndürür.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Belirtilen ReadOnlySpan<T> öğesini kullanarak Encoding öğesini olarak bytekodlar ve sonucu öğesine writeryazar.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Belirtilen ReadOnlySequence<T>charöğesini kullanarak öğesinin kodunu s olarak Encoding çözer ve sonucu öğesine writeryazar.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Belirtilen ReadOnlySequence<T>charöğesini kullanarak öğesinin kodunu s olarak Encoding çözer ve sonucu olarak charsdöndürür.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Belirtilen ReadOnlySpan<T>charöğesini kullanarak öğesinin kodunu s olarak Encoding çözer ve sonucu öğesine writeryazar.
GetString(Encoding, ReadOnlySequence<Byte>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak öğesinin kodunu bir String olarak çözer Encoding.

Ayrıca bkz.

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