ASCIIEncoding.GetCharCount Metoda

Reference

Definice

Obor názvů:: System.Text

Sestavení:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Sestavení:: System.Text.Encoding.Extensions.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů.

Přetížení

GetCharCount(Byte*, Int32)	Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů počínaje zadaným bajtovým ukazatelem.
GetCharCount(Byte[], Int32, Int32)	Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů ze zadaného pole bajtů.
GetCharCount(ReadOnlySpan<Byte>)	Vypočítá počet znaků vytvořených dekódováním zadaného rozsahu bajtů.

GetCharCount(Byte*, Int32)

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Alternativa odpovídající specifikaci CLS: System.Text.ASCIIEncoding.GetCharCount(Byte[], Int32, Int32)

Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů počínaje zadaným bajtovým ukazatelem.

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

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

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

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

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount (byte* bytes, int count);

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

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

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

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int

Parametry

bytes: Byte*

Ukazatel na první bajt k dekódování.

count: Int32

Počet bajtů k dekódování.

Návraty

Int32

Počet znaků vytvořených dekódováním zadané posloupnosti bajtů.

Atributy: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Výjimky

ArgumentNullException

bytes je null.

ArgumentOutOfRangeException

Hodnota count je menší než nula.

-nebo-

Výsledný počet bajtů je větší než maximální počet, který lze vrátit jako celé číslo.

DecoderFallbackException

Došlo k náhradnímu použití (další informace najdete v tématu Kódování znaků v .NET)

-A-

DecoderFallback je nastavená na DecoderExceptionFallbackhodnotu .

Poznámky

K výpočtu přesné velikosti pole potřebné GetChars k uložení výsledných znaků aplikace používá GetCharCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení menší paměti, zatímco GetMaxCharCount metoda se obecně spouští rychleji.

Viz také

Platí pro

.NET 9 a další verze

Produkt	Verze
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetCharCount(Byte[], Int32, Int32)

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

Vypočítá počet znaků vytvořených dekódováním posloupnosti bajtů ze zadaného pole bajtů.

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

Parametry

bytes: Byte[]

Pole bajtů obsahující posloupnost bajtů k dekódování.

index: Int32

Index prvního bajtu k dekódování.

count: Int32

Počet bajtů k dekódování.

Návraty

Int32

Počet znaků vytvořených dekódováním zadané posloupnosti bajtů.

Výjimky

ArgumentNullException

bytes je null.

ArgumentOutOfRangeException

index nebo count je menší než nula.

-nebo-

index a count neoznamují platnou oblast v bytessouboru .

-nebo-

Výsledný počet bajtů je větší než maximální počet, který lze vrátit jako celé číslo.

DecoderFallbackException

Došlo k náhradnímu použití (další informace najdete v tématu Kódování znaků v .NET)

-A-

DecoderFallback je nastavená na DecoderExceptionFallbackhodnotu .

Příklady

Následující příklad ukazuje, jak použít metodu GetCharCount k vrácení počtu znaků produkovaných dekódováním rozsahu prvků v bajtovém poli.

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

Poznámky

Viz také

Platí pro

.NET 9 a další verze

Produkt	Verze
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetCharCount(ReadOnlySpan<Byte>)

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

Vypočítá počet znaků vytvořených dekódováním zadaného rozsahu bajtů.

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

Parametry

bytes: ReadOnlySpan<Byte>

Rozsah obsahující sadu bajtů k dekódování.

Návraty

Int32

Počet znaků vytvořených dekódováním zadaného rozsahu bajtů.

Poznámky

Pokud chcete vypočítat přesnou velikost potřebnou GetChars k uložení výsledných znaků, použijte GetCharCount. K výpočtu maximální velikosti použijte GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení menší paměti, zatímco GetMaxCharCount metoda se obecně spouští rychleji.

Platí pro

.NET 9 a další verze

Produkt	Verze
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9

AI Skills Fest

Sdílet prostřednictvím

ASCIIEncoding.GetCharCount Metoda

Definice

Přetížení

GetCharCount(Byte*, Int32)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetCharCount(Byte[], Int32, Int32)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

GetCharCount(ReadOnlySpan<Byte>)

Parametry

Návraty

Poznámky

Platí pro

Další materiály