Decoder.GetCharCount Yöntem

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Türetilmiş bir sınıfta geçersiz kılındığında, bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.

Aşırı Yüklemeler

Name	Description
GetCharCount(ReadOnlySpan<Byte>, Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, yayılmadaki 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, 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.
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, 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(ReadOnlySpan<Byte>, Boolean)

Kaynak:

Decoder.cs

Türetilmiş bir sınıfta geçersiz kılındığında, yayılmadaki bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar. Parametre, hesaplamadan sonra kod çözücü iç durumunun temizlenip temizlenmeyeceğini gösterir.

public:
 virtual int GetCharCount(ReadOnlySpan<System::Byte> bytes, bool flush);

public virtual int GetCharCount(ReadOnlySpan<byte> bytes, bool flush);

abstract member GetCharCount : ReadOnlySpan<byte> * bool -> int
override this.GetCharCount : ReadOnlySpan<byte> * bool -> int

Public Overridable Function GetCharCount (bytes As ReadOnlySpan(Of Byte), flush As Boolean) As Integer

Parametreler

bytes

ReadOnlySpan<Byte>

Kodunu çözmek için bir bayt aralığı.

flush

Boolean

true hesaplamadan sonra kodlayıcının iç durumunu temizleme benzetimi yapmak için; aksi takdirde , false.

Döndürülenler

Int32

Belirtilen bayt dizisi ve iç arabellekteki baytların kodunu çözerek üretilen karakter sayısı.

Açıklamalar

Bu yöntem kod çözücü durumunu etkilemez.

Sonuçta elde edilen karakterlerin depolanmasını gerektiren GetChars tam arabellek boyutunu hesaplamak için, uygulama kullanmalıdır GetCharCount.

ile GetCharsçağrılırsa flushfalse, kod çözücü veri bloğunun sonundaki baytları bir iç arabellekte depolar ve bunları bir sonraki kod çözme işleminde kullanır. Uygulama, aynı blokta çağrı GetCharCount yapmadan hemen önce bir veri bloğu üzerinde çağrı GetChars yapmalıdır, böylece önceki bloktaki sondaki baytlar hesaplamaya dahil edilir.

GetCharCount(Byte*, Int32, Boolean)

Kaynak:

Decoder.cs

Önemli

Bu API, CLS uyumlu değildir.

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.

public:
 virtual int GetCharCount(System::Byte* bytes, int count, bool flush);

[System.CLSCompliant(false)]
public virtual int GetCharCount(byte* bytes, int count, bool flush);

[<System.CLSCompliant(false)>]
abstract member GetCharCount : nativeptr<byte> * int * bool -> int
override this.GetCharCount : nativeptr<byte> * int * bool -> int

Parametreler

bytes

Byte*

Kodunu çözmek için ilk bayt işaretçisi.

count

Int32

Kodu çözecek bayt sayısı.

flush

Boolean

true hesaplamadan sonra kodlayıcının iç durumunu temizleme benzetimi yapmak için; aksi takdirde , false.

Döndürülenler

Int32

Belirtilen bayt dizisi ve iç arabellekteki baytların kodunu çözerek üretilen karakter sayısı.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

bytes null (Visual Basic .NET'de Nothing).

ArgumentOutOfRangeException

count, sıfırdan küçüktür.

DecoderFallbackException

Geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-ve-

Fallback olarak ayarlanır DecoderExceptionFallback.

Açıklamalar

Bu yöntem kod çözücü durumunu etkilemez.

Sonuçta elde edilen karakterlerin depolanmasını gerektiren GetChars dizi boyutunu tam olarak hesaplamak için, uygulama kullanmalıdır GetCharCount.

ile GetCharsçağrılırsa flushfalse, kod çözücü veri bloğunun sonundaki baytları bir iç arabellekte depolar ve bunları bir sonraki kod çözme işleminde kullanır. Uygulama, aynı blokta çağrı GetCharCount yapmadan hemen önce bir veri bloğu üzerinde çağrı GetChars yapmalıdır, böylece önceki bloktaki sondaki baytlar hesaplamaya dahil edilir.

Ayrıca bkz.

• GetChars(Byte*, Int32, Char*, Int32, Boolean)
• Reset()

GetCharCount(Byte[], Int32, Int32)

Kaynak:

Decoder.cs

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.

public:
 abstract int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);

public abstract int GetCharCount(byte[] bytes, int index, int count);

abstract member GetCharCount : byte[] * int * int -> int

Public MustOverride Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integer

Parametreler

bytes

Byte[]

Kodunu çözmek için bayt sırasını içeren bayt dizisi.

index

Int32

Kodunu çözmek için ilk bayt dizini.

count

Int32

Kodu çözecek bayt sayısı.

Döndürülenler

Int32

Belirtilen bayt dizisi ve iç arabellekteki baytların kodunu çözerek üretilen karakter sayısı.

Özel durumlar

ArgumentNullException

bytes is null (Nothing).

ArgumentOutOfRangeException

index veya count sıfırdan küçüktür.

-veya-

index ve count içinde bytesgeçerli bir aralığı ifade etmeyin.

DecoderFallbackException

Geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-ve-

Fallback olarak ayarlanır DecoderExceptionFallback.

Örnekler

Aşağıdaki kod örneği, dizide GetCharCount belirtilen bayt aralığının kodunu çözmek için gereken karakter sayısını hesaplamak için yönteminin nasıl kullanılacağını gösterir.

using System;
using System.Text;

class DecoderExample {
    public static void Main() {
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        Decoder uniDecoder = Encoding.Unicode.GetDecoder();
        int charCount = uniDecoder.GetCharCount(bytes, 0, bytes.Length);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}

/* This code example produces the following output.

7 characters needed to decode bytes.

*/

Imports System.Text

Class DecoderExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte = { _
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0 _
        }
        
        Dim uniDecoder As Decoder = Encoding.Unicode.GetDecoder()
        Dim charCount As Integer = uniDecoder.GetCharCount(bytes, 0, bytes.Length)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    End Sub
End Class

'This code example produces the following output.
'
'7 characters needed to decode bytes.
'

Açıklamalar

Bu yöntem kod çözücü durumunu etkilemez.

Sonuçta elde edilen karakterlerin depolanmasını gerektiren GetChars dizi boyutunu tam olarak hesaplamak için, uygulama kullanmalıdır GetCharCount.

ile GetCharsçağrılırsa flushfalse, kod çözücü veri bloğunun sonundaki baytları bir iç arabellekte depolar ve bunları bir sonraki kod çözme işleminde kullanır. Uygulama, aynı blokta çağrı GetCharCount yapmadan hemen önce bir veri bloğu üzerinde çağrı GetChars yapmalıdır, böylece önceki bloktaki sondaki baytlar hesaplamaya dahil edilir.

Ayrıca bkz.

• GetChars(Byte[], Int32, Int32, Char[], Int32)
• Reset()

GetCharCount(Byte[], Int32, Int32, Boolean)

Kaynak:

Decoder.cs

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.

public:
 virtual int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count, bool flush);

public virtual int GetCharCount(byte[] bytes, int index, int count, bool flush);

abstract member GetCharCount : byte[] * int * int * bool -> int
override this.GetCharCount : byte[] * int * int * bool -> int

Public Overridable Function GetCharCount (bytes As Byte(), index As Integer, count As Integer, flush As Boolean) As Integer

Parametreler

bytes

Byte[]

Kodunu çözmek için bayt sırasını içeren bayt dizisi.

index

Int32

Kodunu çözmek için ilk bayt dizini.

count

Int32

Kodu çözecek bayt sayısı.

flush

Boolean

true hesaplamadan sonra kodlayıcının iç durumunu temizleme benzetimi yapmak için; aksi takdirde , false.

Döndürülenler

Int32

Belirtilen bayt dizisi ve iç arabellekteki baytların kodunu çözerek üretilen karakter sayısı.

Özel durumlar

ArgumentNullException

bytes is null (Nothing).

ArgumentOutOfRangeException

index veya count sıfırdan küçüktür.

-veya-

index ve count içinde bytesgeçerli bir aralığı ifade etmeyin.

DecoderFallbackException

Geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-ve-

Fallback olarak ayarlanır DecoderExceptionFallback.

Açıklamalar

Bu yöntem kod çözücü durumunu etkilemez.

Sonuçta elde edilen karakterlerin depolanmasını gerektiren GetChars dizi boyutunu tam olarak hesaplamak için, uygulama kullanmalıdır GetCharCount.

ile GetCharsçağrılırsa flushfalse, kod çözücü veri bloğunun sonundaki baytları bir iç arabellekte depolar ve bunları bir sonraki kod çözme işleminde kullanır. Uygulama, aynı blokta çağrı GetCharCount yapmadan hemen önce bir veri bloğu üzerinde çağrı GetChars yapmalıdır, böylece önceki bloktaki sondaki baytlar hesaplamaya dahil edilir.

Ayrıca bkz.

• GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)
• Reset()