Encoder.GetBytes Metódus

Definíció

Névtér:

System.Text

Szerelvények:

netstandard.dll, System.Runtime.dll

Ha felülbírált egy származtatott osztályban, egy karakterkészletet bájtok sorozatába kódol.

Túlterhelések

Name	Description
GetBytes(ReadOnlySpan<Char>, Span<Byte>, Boolean)	Ha egy származtatott osztályban felülbírált, a bemeneti karaktertartományban szereplő karaktereket és a belső pufferben lévő karaktereket bájtok sorozatába kódolja, amelyeket a bemeneti bájtok között tárolnak. A paraméter azt jelzi, hogy az átalakítás után törölje-e a kódoló belső állapotát.
GetBytes(Char*, Int32, Byte*, Int32, Boolean)	Ha egy származtatott osztályban felülbírál, a megadott karaktermutatótól kezdődő karakterkészletet és a belső pufferben lévő karaktereket bájtok sorozatába kódolja, amelyek a megadott bájtmutatótól kezdve vannak tárolva. A paraméter azt jelzi, hogy az átalakítás után törölje-e a kódoló belső állapotát.
GetBytes(Char[], Int32, Int32, Byte[], Int32, Boolean)	Ha egy származtatott osztályban felül van bírálva, a megadott karaktertömb karakterkészletét és a belső pufferben lévő karaktereket a megadott bájttömbbe kódolja. A paraméter azt jelzi, hogy az átalakítás után törölje-e a kódoló belső állapotát.

Megjegyzések

Ne feledje, hogy az objektum menti az Encoder állapotot a következő GetByteshívás között: . Amikor az alkalmazás adatstreamel végzett, a flush paramétert true az utolsó hívásban GetBytes kell beállítania, hogy az állapotinformációk kiürítve legyenek, és hogy a kódolt bájtok megfelelően le legyenek állítva. Ezzel a beállítással a kódoló figyelmen kívül hagyja az adatblokk végén található érvénytelen bájtokat, például a nem egyező helyettesítőket vagy a hiányos kombinációs sorozatokat, és törli a belső puffert.

Az eredményként kapott karakterek tárolásához szükséges pontos pufferméret GetBytes kiszámításához az alkalmazásnak a következőt kell használnia GetByteCount: .

Ha GetBytes a rendszer úgy hívja flush meg, hogy falsea kódoló egy belső pufferben tárolja a záró bájtokat az adatblokk végén, és a következő kódolási műveletben használja őket. Az alkalmazásnak közvetlenül az ugyanazon blokk meghívása GetByteCount előtt meg kell hívnia GetBytes egy adatblokkot, hogy az előző blokk összes záró karaktere szerepeljen a számításban.

Ha az alkalmazás egy bemeneti adatfolyam számos szegmensét szeretné átalakítani, fontolja meg a Convert metódus használatát. GetBytes kivételt eredményez, ha a kimeneti puffer nem elég nagy, de Convert a lehető legtöbb helyet kitölti, és visszaadja az olvasási és bájtos karaktereket. További megjegyzésekért lásd a Encoding.GetBytes témakört.

GetBytes(ReadOnlySpan<Char>, Span<Byte>, Boolean)

Forrás:

Encoder.cs

Ha egy származtatott osztályban felülbírált, a bemeneti karaktertartományban szereplő karaktereket és a belső pufferben lévő karaktereket bájtok sorozatába kódolja, amelyeket a bemeneti bájtok között tárolnak. A paraméter azt jelzi, hogy az átalakítás után törölje-e a kódoló belső állapotát.

public:
 virtual int GetBytes(ReadOnlySpan<char> chars, Span<System::Byte> bytes, bool flush);

public virtual int GetBytes(ReadOnlySpan<char> chars, Span<byte> bytes, bool flush);

abstract member GetBytes : ReadOnlySpan<char> * Span<byte> * bool -> int
override this.GetBytes : ReadOnlySpan<char> * Span<byte> * bool -> int

Public Overridable Function GetBytes (chars As ReadOnlySpan(Of Char), bytes As Span(Of Byte), flush As Boolean) As Integer

Paraméterek

chars

ReadOnlySpan<Char>

Kódolandó karakterfedés.

bytes

Span<Byte>

Bájttartomány az eredményként kapott bájtsor megírásához.

flush

Boolean

truea kódoló belső állapotának törlése az átalakítás után; egyéb esetben. false

Válaszok

Int32

A paraméter által bytes megadott helyen írt bájtok tényleges száma.

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

Forrás:

Encoder.cs

Fontos

Ez az API nem CLS-kompatibilis.

Ha egy származtatott osztályban felülbírál, a megadott karaktermutatótól kezdődő karakterkészletet és a belső pufferben lévő karaktereket bájtok sorozatába kódolja, amelyek a megadott bájtmutatótól kezdve vannak tárolva. A paraméter azt jelzi, hogy az átalakítás után törölje-e a kódoló belső állapotát.

public:
 virtual int GetBytes(char* chars, int charCount, System::Byte* bytes, int byteCount, bool flush);

[System.CLSCompliant(false)]
public virtual int GetBytes(char* chars, int charCount, byte* bytes, int byteCount, bool flush);

[<System.CLSCompliant(false)>]
abstract member GetBytes : nativeptr<char> * int * nativeptr<byte> * int * bool -> int
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int * bool -> int

Paraméterek

chars

Char*

A kódolni kívánt első karakterre mutató mutató.

charCount

Int32

A kódolandó karakterek száma.

bytes

Byte*

Egy mutató arra a helyre, ahol elkezdi írni az eredményként kapott bájtsorozatot.

byteCount

Int32

Az írható bájtok maximális száma.

flush

Boolean

truea kódoló belső állapotának törlése az átalakítás után; egyéb esetben. false

Válaszok

Int32

A paraméter által bytes megadott helyen írt bájtok tényleges száma.

Attribútumok

CLSCompliantAttribute

Kivételek

ArgumentNullException

chars az null (Nothing).

-vagy-

bytes az null (Nothing).

ArgumentOutOfRangeException

charCount vagy byteCount kisebb, mint nulla.

ArgumentException

byteCount kisebb, mint az eredményként kapott bájtok száma.

EncoderFallbackException

Hiba történt (további információ: Acharacter kódolása a .NET)

-és-

Fallback EncoderExceptionFallbackértékre van állítva.

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

Forrás:

Encoder.cs

Ha egy származtatott osztályban felül van bírálva, a megadott karaktertömb karakterkészletét és a belső pufferben lévő karaktereket a megadott bájttömbbe kódolja. A paraméter azt jelzi, hogy az átalakítás után törölje-e a kódoló belső állapotát.

public:
 abstract int GetBytes(cli::array <char> ^ chars, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex, bool flush);

public abstract int GetBytes(char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex, bool flush);

abstract member GetBytes : char[] * int * int * byte[] * int * bool -> int

Public MustOverride Function GetBytes (chars As Char(), charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer, flush As Boolean) As Integer

Paraméterek

chars

Char[]

A kódolandó karaktereket tartalmazó karaktertömb.

charIndex

Int32

Az első kódolandó karakter indexe.

charCount

Int32

A kódolandó karakterek száma.

bytes

Byte[]

Az eredményként kapott bájtsorozatot tartalmazó bájttömb.

byteIndex

Int32

Az az index, amelynél elkezdi írni az eredményként kapott bájtsorozatot.

flush

Boolean

truea kódoló belső állapotának törlése az átalakítás után; egyéb esetben. false

Válaszok

Int32

A beírt bytesbájtok tényleges száma.

Kivételek

ArgumentNullException

chars az null (Nothing).

-vagy-

bytes az null (Nothing).

ArgumentOutOfRangeException

charIndex vagy charCountbyteIndex kisebb, mint nulla.

-vagy-

charIndex és charCount ne jelölje az érvényes tartományt a következőben chars: .

-vagy-

byteIndex érvénytelen index a következőben bytes: .

ArgumentException

bytes nem rendelkezik elegendő kapacitással a tömb végétől byteIndex a kapott bájtok elhelyezéséhez.

EncoderFallbackException

Hiba történt (további információ: Acharacter kódolása a .NET)

-és-

Fallback EncoderExceptionFallbackértékre van állítva.

Példák

Az alábbi példa bemutatja, hogyan kódolhat több elemtartományt egy karaktertömbből, és hogyan tárolhatja a kódolt bájtokat egy bájttömb elemeinek egy tartományában. A GetByteCount metódus a szükséges tömb GetBytesméretének meghatározására szolgál.

using System;
using System.Text;

class EncoderExample {
    public static void Main() {
        Byte[] bytes;
        // 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);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = uniEncoder.GetBytes(chars, 0, chars.Length, bytes, 0, true);
        
        Console.WriteLine(
            "{0} bytes used to encode characters.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}

/* This code example produces the following output.

8 bytes used to encode characters.
Encoded bytes: [35][0][37][0][160][3][163][3]

*/

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class EncoderExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte
        ' 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)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = _
            uniEncoder.GetBytes(chars, 0, chars.Length, bytes, 0, True)
        
        Console.WriteLine( _
            "{0} bytes used to encode characters.", _
            bytesEncodedCount _
        )
        
        Console.Write("Encoded bytes: ")
        Dim b As Byte
        For Each b In  bytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
    End Sub
End Class

'This code example produces the following output.
'8 bytes used to encode characters.
'Encoded bytes: [35][0][37][0][160][3][163][3]
'