Encoder.GetByteCount Metoda

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ů vyprodukovaných pomocí kódování sady znaků.

Přetížení

GetByteCount(ReadOnlySpan<Char>, Boolean)	Při přepsání v odvozené třídě vypočítá počet bajtů vyprodukovaných pomocí kódování sady znaků v rozpětí ' chars '. Parametr určuje, zda se má po výpočtu vymazat vnitřní stav kodéru.
GetByteCount(Char*, Int32, Boolean)	Při přepsání v odvozené třídě vypočítá počet bajtů vyprodukovaných pomocí kódování sady znaků počínaje zadaným ukazatelem znaku. Parametr určuje, zda se má po výpočtu vymazat vnitřní stav kodéru.
GetByteCount(Char[], Int32, Int32, Boolean)	Při přepsání v odvozené třídě vypočítá počet bajtů vyprodukovaných pomocí kódování sady znaků ze zadaného pole znaků. Parametr určuje, zda se má po výpočtu vymazat vnitřní stav kodéru.

Poznámky

Tato metoda nemá vliv na stav kodéru.

Chcete-li vypočítat přesnou velikost pole, která GetBytes vyžaduje uložení výsledných bajtů, aplikace by měla použít GetByteCount .

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

GetByteCount(ReadOnlySpan<Char>, Boolean)

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

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ů pro kódování.

flush

Boolean

true pro simulaci 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ů vyprodukovaných kódováním zadaných znaků a všech znaků ve vnitřní vyrovnávací paměti.

GetByteCount(Char*, Int32, Boolean)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

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

public:
 virtual int GetByteCount(char* chars, int count, bool flush);

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

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

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 ke kódování.

count

Int32

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

flush

Boolean

true pro simulaci 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ů vyprodukovaných kódováním zadaných znaků a všech znaků ve vnitřní vyrovnávací paměti.

Atributy

CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Výjimky

ArgumentNullException

charsje null ( Nothing v Visual Basic .net).

ArgumentOutOfRangeException

Hodnota count je menší než nula.

EncoderFallbackException

Došlo k chybě Fallback (Další informace najdete v tématu kódování znaků v rozhraní .NET).

ani

Fallback je nastaven na EncoderExceptionFallback .

Viz také

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

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

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

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é mají být zakódovány.

index

Int32

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

count

Int32

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

flush

Boolean

true pro simulaci 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ů vyprodukovaných kódováním zadaných znaků a všech znaků ve vnitřní vyrovnávací paměti.

Výjimky

ArgumentNullException

chars je null.

ArgumentOutOfRangeException

index nebo count je menší než nula.

-nebo-

index a count neměňte si platný rozsah v chars .

EncoderFallbackException

Došlo k chybě Fallback (Další informace najdete v tématu kódování znaků v rozhraní .NET).

ani

Fallback je nastaven na EncoderExceptionFallback .

Příklady

Následující příklad kódu ukazuje, jak použít GetByteCount metodu k vrácení počtu bajtů potřebných ke kódování pole znaků pomocí kódování 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é

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