ASCIIEncoding.GetCharCount Yöntem

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Text.Encoding.Extensions.dll

Bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.

Aşırı Yüklemeler

GetCharCount(Byte*, Int32)	Belirtilen bayt işaretçisinde başlayan bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(Byte[], Int32, Int32)	Belirtilen bayt dizisinden bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(ReadOnlySpan<Byte>)	Belirtilen bayt aralığının kodunu çözerek üretilen karakter sayısını hesaplar.

GetCharCount(Byte*, Int32)

Kaynak:

ASCIIEncoding.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif

System.Text.ASCIIEncoding.GetCharCount(Byte[], Int32, Int32)

Belirtilen bayt işaretçisinde başlayan bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.

public:
 override int GetCharCount(System::Byte* bytes, int count);

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

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

Parametreler

bytes

Byte*

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

count

Int32

Kodu çözecek bayt sayısı.

Döndürülenler

Int32

Belirtilen bayt dizisi çözülerek oluşturulan karakter sayısı.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

bytes null.

ArgumentOutOfRangeException

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

-veya-

Elde edilen bayt sayısı, tamsayı olarak döndürülebilecek maksimum sayıdan büyüktür.

DecoderFallbackException

Geri dönüş oluştu (daha fazla bilgi için bkz. .NETKarakter Kodlaması )

-ve-

DecoderFallback DecoderExceptionFallbackolarak ayarlanır.

Açıklamalar

Elde edilen karakterleri depolamak için GetChars gereken dizi boyutunu tam olarak hesaplamak için uygulama GetCharCountkullanır. En büyük dizi boyutunu hesaplamak için uygulama GetMaxCharCountkullanmalıdır. GetCharCount yöntemi genellikle daha az bellek ayırmaya izin verirken, GetMaxCharCount yöntemi genellikle daha hızlı yürütülür.

Ayrıca bkz.

• GetChars
• GetMaxCharCount(Int32)
• GetDecoder()

GetCharCount(Byte[], Int32, Int32)

Kaynak:

ASCIIEncoding.cs

Belirtilen bayt dizisinden bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.

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

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

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

Public Overrides 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 çözülerek oluşturulan karakter sayısı.

Özel durumlar

ArgumentNullException

bytes null.

ArgumentOutOfRangeException

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

-veya-

index ve countbytesiçinde geçerli bir aralığı ifade etmeyin.

-veya-

Elde edilen bayt sayısı, tamsayı olarak döndürülebilecek maksimum sayıdan büyüktür.

DecoderFallbackException

Geri dönüş oluştu (daha fazla bilgi için bkz. .NETKarakter Kodlaması )

-ve-

DecoderFallback DecoderExceptionFallbackolarak ayarlanır.

Örnekler

Aşağıdaki örnekte, bayt dizisindeki bir öğe aralığının kodunu çözerek üretilen karakter sayısını döndürmek için GetCharCount yönteminin nasıl kullanılacağı gösterilmektedir.

using namespace System;
using namespace System::Text;
int main()
{
   array<Byte>^bytes = {65,83,67,73,73,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int charCount = ascii->GetCharCount( bytes, 6, 8 );
   Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Byte[] bytes = new Byte[] {
             65,  83,  67,  73,  73,  32,  69,
            110,  99, 111, 100, 105, 110, 103,
             32,  69, 120,  97, 109, 112, 108, 101
        };

        ASCIIEncoding ascii = new ASCIIEncoding();
        int charCount = ascii.GetCharCount(bytes, 6, 8);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim bytes() As Byte = { _
             65,  83,  67,  73,  73,  32,  69, _
            110,  99, 111, 100, 105, 110, 103, _
             32,  69, 120,  97, 109, 112, 108, 101}
      
        Dim ascii As New ASCIIEncoding()
        Dim charCount As Integer = ascii.GetCharCount(bytes, 6, 8)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    End Sub
End Class

Açıklamalar

Elde edilen karakterleri depolamak için GetChars gereken dizi boyutunu tam olarak hesaplamak için uygulama GetCharCountkullanır. En büyük dizi boyutunu hesaplamak için uygulama GetMaxCharCountkullanmalıdır. GetCharCount yöntemi genellikle daha az bellek ayırmaya izin verirken, GetMaxCharCount yöntemi genellikle daha hızlı yürütülür.

Ayrıca bkz.

• GetChars
• GetMaxCharCount(Int32)
• GetDecoder()

GetCharCount(ReadOnlySpan<Byte>)

Kaynak:

ASCIIEncoding.cs

Belirtilen bayt aralığının kodunu çözerek üretilen karakter sayısını hesaplar.

public:
 override int GetCharCount(ReadOnlySpan<System::Byte> bytes);

public override int GetCharCount (ReadOnlySpan<byte> bytes);

override this.GetCharCount : ReadOnlySpan<byte> -> int

Public Overrides Function GetCharCount (bytes As ReadOnlySpan(Of Byte)) As Integer

Parametreler

bytes

ReadOnlySpan<Byte>

Kodunu çözmek için bayt kümesini içeren yayılma alanı.

Döndürülenler

Int32

Belirtilen bayt aralığının kodunu çözerek oluşturulan karakter sayısı.

Açıklamalar

Elde edilen karakterleri depolamak için GetChars gereken tam boyutu hesaplamak için GetCharCountkullanın. En büyük boyutu hesaplamak için GetMaxCharCountkullanın. GetCharCount yöntemi genellikle daha az bellek ayırmaya izin verirken, GetMaxCharCount yöntemi genellikle daha hızlı yürütülür.