Decoder Sınıf

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

mscorlib.dll

Kodlanmış bayt dizisini bir karakter kümesine dönüştürür.

public ref class Decoder abstract

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Decoder

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

Public MustInherit Class Decoder

Devralma

Object

Decoder

Öznitelikler

SerializableAttribute ComVisibleAttribute

Örnekler

Aşağıdaki örnekte, iki farklı bayt dizisini karakter dizisine dönüştürmek için bir kullanımı Decoder gösterilmektedir. Karakterin baytlarından biri dizileri kaplar. Bu, bir akışı okurken bir StreamReader nesnenin dahili olarak yaptıklarına benzer.

using System;
using System.Text;
public class dec
{
    public static void Main()
    {
        // These bytes in UTF-8 correspond to 3 different Unicode
        // characters: space (U+0020), # (U+0023), and the biohazard
        // symbol (U+2623).  Note the biohazard symbol requires 3 bytes
        // in UTF-8 (hexadecimal e2, 98, a3).  Decoders store state across
        // multiple calls to GetChars, handling the case when one char
        // is in multiple byte arrays.
        byte[] bytes1 = { 0x20, 0x23, 0xe2 };
        byte[] bytes2 = { 0x98, 0xa3 };
        char[] chars = new char[3];

        Decoder d = Encoding.UTF8.GetDecoder();
        int charLen = d.GetChars(bytes1, 0, bytes1.Length, chars, 0);
        // The value of charLen should be 2 now.
        charLen += d.GetChars(bytes2, 0, bytes2.Length, chars, charLen);
        foreach(char c in chars)
            Console.Write("U+{0:X4}  ", (ushort)c);
    }
}

Imports System.Text

Public Class dec
    
    Public Shared Sub Main()
        ' These bytes in UTF-8 correspond to 3 different Unicode
        ' characters: space (U+0020), # (U+0023), and the biohazard
        ' symbol (U+2623).  Note the biohazard symbol requires 3 bytes
        ' in UTF-8 (hexadecimal e2, 98, a3).  Decoders store state across
        ' multiple calls to GetChars, handling the case when one char
        ' is in multiple byte arrays.
        Dim bytes1 As Byte() =  {&H20, &H23, &HE2}
        Dim bytes2 As Byte() =  {&H98, &HA3}
        Dim chars(3) As Char
        
        Dim d As Decoder = Encoding.UTF8.GetDecoder()
        Dim charLen As Integer = d.GetChars(bytes1, 0, bytes1.Length, chars, 0)
        ' The value of charLen should be 2 now.
        charLen += d.GetChars(bytes2, 0, bytes2.Length, chars, charLen)
        Dim c As Char
        For Each c In  chars
            Console.Write("U+{0:X4}  ", Convert.ToUInt16(c) )
        Next c
    End Sub
End Class

Açıklamalar

sınıfının bir uygulamasının Decoder örneğini almak için bir Encoding uygulamanın yöntemini çağırınGetDecoder.

GetCharCount yöntemi, bayt dizisinin kodunun çözülmesiyle sonuçlanan karakter sayısını belirler ve GetChars yöntem gerçek kod çözme işlemini gerçekleştirir. Sınıfında bu yöntemlerin her ikisinin de birkaç sürümü vardır Decoder . Daha fazla bilgi için bkz. Encoding.GetChars. Nesne Decoder , bloklara yayılan bayt dizilerinin kodunu doğru bir şekilde çözebilmesi için GetChars ardışık çağrılar veya Convert yöntemler arasında durum bilgilerini tutar. ayrıca Decoder veri bloklarının sonundaki sondaki baytları korur ve sonraki kod çözme işleminde sondaki baytları kullanır. Bu nedenle ve GetDecoderGetEncoder ağ iletim ve dosya işlemleri için yararlıdır çünkü bu işlemler genellikle tam bir veri akışı yerine veri bloklarıyla ilgilenir.

Note

Uygulama bir veri akışıyla tamamlandığında, parametresini true uygun yöntem çağrısında olarak ayarlayarak flush durum bilgilerinin temizlendiğinden emin olmalıdır. Bir özel durum oluşursa veya uygulama akışları değiştirirse, nesnenin iç durumunu Decoder temizlemek için çağrısı Reset yapmalıdır.

Uygulayanlara Notlar

Uygulamanız bu sınıftan devraldığında tüm üyeleri geçersiz kılmalıdır.

Oluşturucular

Name	Description
Decoder()	Decoder sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
Fallback	Geçerli Decoder nesne için bir DecoderFallback nesne alır veya ayarlar.
FallbackBuffer	DecoderFallbackBuffer Geçerli Decoder nesneyle ilişkili nesneyi alır.

Yöntemler

Name	Description
Convert(Byte[], Int32, Int32, Char[], Int32, Int32, Boolean, Int32, Int32, Boolean)	Kodlanmış bayt dizisini UTF-16 ile kodlanmış karakterlere dönüştürür ve sonucu bir karakter dizisinde depolar.
Convert(Byte*, Int32, Char*, Int32, Boolean, Int32, Int32, Boolean)	Kodlanmış baytlardan oluşan bir arabelleği UTF-16 ile kodlanmış karakterlere dönüştürür ve sonucu başka bir arabellekte depolar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetCharCount(Byte[], Int32, Int32, Boolean)	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. Parametre, hesaplamadan sonra kod çözücü iç durumunun temizlenip temizlenmeyeceğini gösterir.
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*, Int32, Boolean)	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. Parametre, hesaplamadan sonra kod çözücü iç durumunun temizlenip temizlenmeyeceğini gösterir.
GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisinden bir bayt dizisinin ve iç arabellekteki tüm baytların kodunu belirtilen karakter dizisine çözer. Parametre, dönüştürmeden sonra kod çözücü iç durumunun temizlenip temizlenmeyeceğini gösterir.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisinden bir bayt dizisinin ve iç arabellekteki tüm baytların kodunu belirtilen karakter dizisine çözer.
GetChars(Byte*, Int32, Char*, Int32, Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt işaretçisinde başlayan bir bayt dizisinin ve iç arabellekteki tüm baytların kodunu, belirtilen karakter işaretçisinde başlayarak depolanan bir dizi karaktere dönüştürür. Parametre, dönüştürmeden sonra kod çözücü iç durumunun temizlenip temizlenmeyeceğini gösterir.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Reset()	Türetilmiş bir sınıfta geçersiz kılındığında kod çözücüsü ilk durumuna geri döner.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Encoder
• Encoding
• GetChars(Byte[], Int32, Int32)
• Kodlamaları Anlama