ASCIIEncoding.GetByteCount Metoda

Reference

Definice

Obor názvů:: System.Text

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

Sestavení:: mscorlib.dll, 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 bajtů vytvořených kódováním sady znaků.

Přetížení

GetByteCount(ReadOnlySpan<Char>)	Vypočítá počet bajtů vytvořených kódováním zadaného rozsahu znaků.
GetByteCount(String)	Vypočítá počet bajtů vytvořených kódováním znaků v zadaném Stringznaku .
GetByteCount(Char*, Int32)	Vypočítá počet bajtů vytvořených kódováním sady znaků počínaje zadaným znakovým ukazatelem.
GetByteCount(Char[], Int32, Int32)	Vypočítá počet bajtů vytvořených kódováním sady znaků ze zadaného pole znaků.

GetByteCount(ReadOnlySpan<Char>)

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

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

public:
 override int GetByteCount(ReadOnlySpan<char> chars);

public override int GetByteCount (ReadOnlySpan<char> chars);

override this.GetByteCount : ReadOnlySpan<char> -> int

Public Overrides Function GetByteCount (chars As ReadOnlySpan(Of Char)) As Integer

Parametry

chars: ReadOnlySpan<Char>

Rozsah, který obsahuje sadu znaků, které se mají kódovat.

Návraty

Int32

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

Poznámky

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

Platí pro

GetByteCount(String)

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

Vypočítá počet bajtů vytvořených kódováním znaků v zadaném Stringznaku .

public:
 override int GetByteCount(System::String ^ chars);

public override int GetByteCount (string chars);

override this.GetByteCount : string -> int

Public Overrides Function GetByteCount (chars As String) As Integer

Parametry

chars: String

Obsahující String sadu znaků, které se mají kódovat.

Návraty

Int32

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

Výjimky

ArgumentNullException

chars je null.

ArgumentOutOfRangeException

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

EncoderFallbackException

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

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Příklady

Následující příklad ukazuje, jak použít metodu GetByteCount k vrácení počtu bajtů potřebných ke kódování řetězce pomocí ASCIIEncoding.

using namespace System;
using namespace System::Text;
int main()
{
   String^ chars = "ASCII Encoding Example";
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = ascii->GetByteCount( chars );
   Console::WriteLine( " {0} bytes needed to encode string.", byteCount );
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        String chars = "ASCII Encoding Example";

        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = ascii.GetByteCount(chars);
        Console.WriteLine(
            "{0} bytes needed to encode string.", byteCount
        );
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim chars As String = "ASCII Encoding Example"

        Dim ascii As New ASCIIEncoding()
        Dim byteCount As Integer = ascii.GetByteCount(chars)
        Console.WriteLine("{0} bytes needed to encode string.", byteCount)
    End Sub
End Class

Poznámky

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

Viz také

Platí pro

GetByteCount(Char*, 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.GetByteCount(Char[], Int32, Int32)

Vypočítá počet bajtů vytvořených kódováním sady znaků počínaje zadaným znakovým ukazatelem.

public:
 override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetByteCount (char* chars, int count);

[System.CLSCompliant(false)]
public override int GetByteCount (char* chars, int count);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount (char* chars, int count);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount (char* chars, int count);

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

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

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

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

Parametry

chars: Char*

Ukazatel na první znak, který se má zakódovat.

count: Int32

Počet znaků, které mají být zakódovány.

Návraty

Int32

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

Atributy: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Výjimky

ArgumentNullException

chars 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.

EncoderFallbackException

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

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Poznámky

Viz také

Platí pro

GetByteCount(Char[], Int32, Int32)

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

Zdroj:: ASCIIEncoding.cs

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

public:
 override int GetByteCount(cli::array <char> ^ chars, int index, int count);

public override int GetByteCount (char[] chars, int index, int count);

override this.GetByteCount : char[] * int * int -> int

Public Overrides Function GetByteCount (chars As Char(), index As Integer, count As Integer) As Integer

Parametry

chars: Char[]

Pole znaků obsahující sadu znaků, které se mají zakódovat.

index: Int32

Index prvního znaku, který má být kódován.

count: Int32

Počet znaků, které mají být zakódovány.

Návraty

Int32

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

Výjimky

ArgumentNullException

chars je null.

ArgumentOutOfRangeException

index nebo count je menší než nula.

-nebo-

index a count neoznamují platnou oblast v charssouboru .

-nebo-

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

EncoderFallbackException

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

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Příklady

Následující příklad ukazuje, jak použít metodu GetByteCount k vrácení počtu bajtů potřebných ke kódování pole znaků Unicode pomocí ASCIIEncoding.

using namespace System;
using namespace System::Text;
int main()
{
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = ascii->GetByteCount( chars, 1, 2 );
   Console::WriteLine( " {0} bytes needed to encode characters.", byteCount.ToString() );
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };

        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = ascii.GetByteCount(chars, 1, 2);
        Console.WriteLine(
            "{0} bytes needed to encode characters.", byteCount
        );
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class ASCIIEncodingExample
    Public Shared Sub Main()
        ' Unicode characters.
        ' ChrW(35)  = #
        ' ChrW(37)  = %
        ' ChrW(928) = Pi
        ' ChrW(931) = Sigma
        Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}

        Dim ascii As New ASCIIEncoding()
        Dim byteCount As Integer = ascii.GetByteCount(chars, 1, 2)
        Console.WriteLine("{0} bytes needed to encode characters.", byteCount)
    End Sub
End Class

Poznámky

Viz také

Platí pro

Sdílet prostřednictvím

ASCIIEncoding.GetByteCount Metoda

Definice

Přetížení

GetByteCount(ReadOnlySpan<Char>)

Parametry

Návraty

Poznámky

Platí pro

GetByteCount(String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

GetByteCount(Char*, Int32)

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

GetByteCount(Char[], Int32, Int32)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály