Encoder.GetBytes Metoda

Definicja

Przestrzeń nazw:

System.Text

Zestaw:

mscorlib.dll

Po zastąpieniu w klasie pochodnej koduje zestaw znaków w sekwencji bajtów.

Przeciążenia

Nazwa	Opis
GetBytes(Char*, Int32, Byte*, Int32, Boolean)	Po zastąpieniu w klasie pochodnej koduje zestaw znaków rozpoczynających się od określonego wskaźnika znaku i wszystkich znaków w buforze wewnętrznym w sekwencji bajtów przechowywanych począwszy od określonego wskaźnika bajtów. Parametr wskazuje, czy wyczyścić stan wewnętrzny kodera po konwersji.
GetBytes(Char[], Int32, Int32, Byte[], Int32, Boolean)	Po zastąpieniu w klasie pochodnej koduje zestaw znaków z określonej tablicy znaków i wszelkie znaki w buforze wewnętrznym do określonej tablicy bajtów. Parametr wskazuje, czy wyczyścić stan wewnętrzny kodera po konwersji.

Uwagi

Pamiętaj, że Encoder obiekt zapisuje stan między wywołaniami funkcji GetBytes. Po zakończeniu działania aplikacji ze strumieniem danych należy ustawić flush parametr na true w ostatnim wywołaniu, aby GetBytes upewnić się, że informacje o stanie są opróżniane i że zakodowane bajty są prawidłowo zakończone. Dzięki temu ustawieniu koder ignoruje nieprawidłowe bajty na końcu bloku danych, takie jak niedopasowane zastępcze lub niekompletne sekwencje łączące i czyści wewnętrzny bufor.

Aby obliczyć dokładny rozmiar buforu, który GetBytes wymaga przechowywania znaków wynikowych, aplikacja powinna użyć polecenia GetByteCount.

Jeśli GetBytes jest wywoływana z ustawioną wartością flushfalse, koder przechowuje końcowe bajty na końcu bloku danych w buforze wewnętrznym i używa ich w następnej operacji kodowania. Aplikacja powinna wywołać GetByteCount blok danych bezpośrednio przed wywołaniem GetBytes tego samego bloku, aby wszystkie końcowe znaki z poprzedniego bloku były uwzględniane w obliczeniach.

Jeśli aplikacja ma konwertować wiele segmentów strumienia wejściowego, rozważ użycie Convert metody . GetBytes Zgłosi wyjątek, jeśli bufor wyjściowy nie jest wystarczająco duży, ale Convert wypełni jak najwięcej miejsca i zwróci znaki odczytane i bajty zapisane. Zobacz również temat, Encoding.GetBytes aby uzyskać więcej komentarzy.

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

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Po zastąpieniu w klasie pochodnej koduje zestaw znaków rozpoczynających się od określonego wskaźnika znaku i wszystkich znaków w buforze wewnętrznym w sekwencji bajtów przechowywanych począwszy od określonego wskaźnika bajtów. Parametr wskazuje, czy wyczyścić stan wewnętrzny kodera po konwersji.

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

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

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

Parametry

chars

Char*

Wskaźnik do pierwszego znaku w celu zakodowania.

charCount

Int32

Liczba znaków do zakodowania.

bytes

Byte*

Wskaźnik do lokalizacji, w której należy rozpocząć pisanie wynikowej sekwencji bajtów.

byteCount

Int32

Maksymalna liczba bajtów do zapisu.

flush

Boolean

true w celu wyczyszczenia stanu wewnętrznego kodera po konwersji; w przeciwnym razie, false.

Zwraca

Int32

Rzeczywista liczba bajtów zapisanych w lokalizacji wskazanej bytes przez parametr .

Atrybuty

CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Wyjątki

ArgumentNullException

chars is null (Nothing).

— lub —

bytes is null (Nothing).

ArgumentOutOfRangeException

charCount lub byteCount jest mniejsza niż zero.

ArgumentException

byteCount jest mniejsza niż wynikowa liczba bajtów.

EncoderFallbackException

Wystąpił powrót (aby uzyskać więcej informacji, zobacz Kodowanie znaków na platformie .NET)

— i —

Fallback jest ustawiony na EncoderExceptionFallback.

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

Po zastąpieniu w klasie pochodnej koduje zestaw znaków z określonej tablicy znaków i wszelkie znaki w buforze wewnętrznym do określonej tablicy bajtów. Parametr wskazuje, czy wyczyścić stan wewnętrzny kodera po konwersji.

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

Parametry

chars

Char[]

Tablica znaków zawierająca zestaw znaków do kodowania.

charIndex

Int32

Indeks pierwszego znaku do zakodowania.

charCount

Int32

Liczba znaków do zakodowania.

bytes

Byte[]

Tablica bajtów zawierająca wynikową sekwencję bajtów.

byteIndex

Int32

Indeks, w którym należy rozpocząć pisanie wynikowej sekwencji bajtów.

flush

Boolean

true w celu wyczyszczenia stanu wewnętrznego kodera po konwersji; w przeciwnym razie, false.

Zwraca

Int32

Rzeczywista liczba bajtów zapisanych w pliku bytes.

Wyjątki

ArgumentNullException

chars is null (Nothing).

— lub —

bytes is null (Nothing).

ArgumentOutOfRangeException

charIndex lub charCountbyteIndex jest mniejszy niż zero.

— lub —

charIndex i charCount nie oznaczają prawidłowego zakresu w elem chars.

— lub —

byteIndex nie jest prawidłowym indeksem w pliku bytes.

ArgumentException

bytes nie ma wystarczającej pojemności od byteIndex do końca tablicy, aby pomieścić wynikowe bajty.

EncoderFallbackException

Wystąpił powrót (aby uzyskać więcej informacji, zobacz Kodowanie znaków na platformie .NET)

— i —

Fallback jest ustawiony na EncoderExceptionFallback.

Przykłady

W poniższym przykładzie pokazano, jak zakodować szereg elementów z tablicy znaków i przechowywać zakodowane bajty w zakresie elementów w tablicy bajtów. Metoda GetByteCount służy do określania rozmiaru tablicy wymaganej przez GetByteselement .

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]
'