Encoder.GetByteCount Metoda

  • Reference

Definice

Obor názvů:
System.Text
Sestavení:
System.Runtime.dll
Sestavení:
netstandard.dll
Sestavení:
mscorlib.dll
Sestavení:
System.Text.Encoding.dll

Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním sady znaků.

Přetížení

GetByteCount(ReadOnlySpan<Char>, Boolean)

Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním sady znaků v rozsahu znaků chars. Parametr určuje, jestli se má vymazat vnitřní stav kodéru po výpočtu.
GetByteCount(Char*, Int32, Boolean)

Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním sady znaků počínaje zadaným znakovým ukazatelem. Parametr určuje, jestli se má vymazat vnitřní stav kodéru po výpočtu.
GetByteCount(Char[], Int32, Int32, Boolean)

Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním sady znaků ze zadaného pole znaků. Parametr určuje, jestli se má vymazat vnitřní stav kodéru po výpočtu.

Poznámky

Tato metoda nemá vliv na stav kodéru.

K výpočtu přesné velikosti pole, která GetBytes je nutná k uložení výsledných bajtů, by aplikace měla použít GetByteCount.

Pokud GetBytes je volána s flush nastavenou na false, kodér ukládá koncové znaky na konci bloku dat do interní vyrovnávací paměti a použije je v další operaci kódování. Aplikace by měla volat GetByteCount blok dat bezprostředně před voláním GetBytes stejného bloku, aby se do výpočtu zahrnuly všechny koncové znaky z předchozího bloku.

GetByteCount(ReadOnlySpan<Char>, Boolean)

Zdroj:
Encoder.cs
Zdroj:
Encoder.cs
Zdroj:
Encoder.cs

Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním sady znaků v rozsahu znaků chars. Parametr určuje, jestli se má vymazat vnitřní stav kodéru po výpočtu.

public:
 virtual int GetByteCount(ReadOnlySpan<char> chars, bool flush);
public virtual int GetByteCount (ReadOnlySpan<char> chars, bool flush);
abstract member GetByteCount : ReadOnlySpan<char> * bool -> int
override this.GetByteCount : ReadOnlySpan<char> * bool -> int
Public Overridable Function GetByteCount (chars As ReadOnlySpan(Of Char), flush As Boolean) As Integer

Parametry

chars
ReadOnlySpan<Char>

Rozsah znaků, který se má kódovat.

flush
Boolean

truesimulace vymazání vnitřního stavu kodéru po výpočtu; v opačném případě . false

Návraty

Int32

Počet bajtů vytvořených kódováním zadaných znaků a všech znaků v interní vyrovnávací paměti.

Platí pro

GetByteCount(Char*, Int32, Boolean)

Zdroj:
Encoder.cs
Zdroj:
Encoder.cs
Zdroj:
Encoder.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním sady znaků počínaje zadaným znakovým ukazatelem. Parametr určuje, jestli se má vymazat vnitřní stav kodéru po výpočtu.

public:
 virtual int GetByteCount(char* chars, int count, bool flush);
[System.CLSCompliant(false)]
public virtual int GetByteCount (char* chars, int count, bool flush);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetByteCount (char* chars, int count, bool flush);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual int GetByteCount (char* chars, int count, bool flush);
[<System.CLSCompliant(false)>]
abstract member GetByteCount : nativeptr<char> * int * bool -> int
override this.GetByteCount : nativeptr<char> * int * bool -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetByteCount : nativeptr<char> * int * bool -> int
override this.GetByteCount : nativeptr<char> * int * bool -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member GetByteCount : nativeptr<char> * int * bool -> int
override this.GetByteCount : nativeptr<char> * int * bool -> 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.

flush
Boolean

truesimulace vymazání vnitřního stavu kodéru po výpočtu; v opačném případě . false

Návraty

Int32

Počet bajtů vytvořených kódováním zadaných znaků a všech znaků v interní vyrovnávací paměti.

Atributy
CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Výjimky

ArgumentNullException

chars is null (Nothing v jazyce Visual Basic .NET).

ArgumentOutOfRangeException

Hodnota count je menší než nula.

EncoderFallbackException

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

-A-

Fallback je nastavená na EncoderExceptionFallbackhodnotu .

Viz také

Platí pro

GetByteCount(Char[], Int32, Int32, Boolean)

Zdroj:
Encoder.cs
Zdroj:
Encoder.cs
Zdroj:
Encoder.cs

Při přepsání v odvozené třídě vypočítá počet bajtů produkovaných kódováním sady znaků ze zadaného pole znaků. Parametr určuje, jestli se má vymazat vnitřní stav kodéru po výpočtu.

public:
 abstract int GetByteCount(cli::array <char> ^ chars, int index, int count, bool flush);
public abstract int GetByteCount (char[] chars, int index, int count, bool flush);
abstract member GetByteCount : char[] * int * int * bool -> int
Public MustOverride Function GetByteCount (chars As Char(), index As Integer, count As Integer, flush As Boolean) 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.

flush
Boolean

truesimulace vymazání vnitřního stavu kodéru po výpočtu; v opačném případě . false

Návraty

Int32

Počet bajtů vytvořených kódováním zadaných znaků a všech znaků v interní vyrovnávací paměti.

Výjimky

ArgumentNullException

chars je null.

ArgumentOutOfRangeException

index nebo count je menší než nula.

-nebo-

index a count neoznamují platnou oblast v charssouboru .

EncoderFallbackException

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

-A-

Fallback je nastavená na EncoderExceptionFallbackhodnotu .

Příklady

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

using namespace System;
using namespace System::Text;
int main()
{
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   Encoder^ uniEncoder = Encoding::Unicode->GetEncoder();
   int byteCount = uniEncoder->GetByteCount( chars, 0, chars->Length, true );
   Console::WriteLine( "{0} bytes needed to encode characters.", byteCount );
}

/* This code example produces the following output. 

8 bytes needed to encode characters.

*/

using System;
using System.Text;

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

        Encoder uniEncoder = Encoding.Unicode.GetEncoder();
        int byteCount = uniEncoder.GetByteCount(chars, 0, chars.Length, true);
        Console.WriteLine(
            "{0} bytes needed to encode characters.", byteCount
        );
    }
}

/* This example produces the following output.

8 bytes needed to encode characters.

*/

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class EncoderExample
    
    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 uniEncoder As Encoder = Encoding.Unicode.GetEncoder()
        Dim byteCount As Integer = _
            uniEncoder.GetByteCount(chars, 0, chars.Length, True)
        Console.WriteLine("{0} bytes needed to encode characters.", byteCount)
    End Sub
End Class
'
'This example produces the following output.
'
'8 bytes needed to encode characters.
'

Viz také

Platí pro