UTF8Encoding.GetBytes Metoda

Definice

Obor názvů:

System.Text

Sestavení:

netstandard.dll, System.Text.Encoding.Extensions.dll

Zakóduje sadu znaků do posloupnosti bajtů.

Přetížení

Name	Description
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Zakóduje zadané rozsahy znaků do zadaného rozsahu bajtů.
GetBytes(Char*, Int32, Byte*, Int32)	Zakóduje sadu znaků začínající zadaným ukazatelem znaků do posloupnosti bajtů, které jsou uloženy od zadaného bajtového ukazatele.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Zakóduje sadu znaků ze zadaného pole znaků do zadaného bajtového pole.
GetBytes(String, Int32, Int32, Byte[], Int32)	Zakóduje sadu znaků ze zadaného String pole bajtů.

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

Zdroj:

UTF8Encoding.cs

Zakóduje zadané rozsahy znaků do zadaného rozsahu bajtů.

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

public override int GetBytes(ReadOnlySpan<char> chars, Span<byte> bytes);

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

Public Overrides Function GetBytes (chars As ReadOnlySpan(Of Char), bytes As Span(Of Byte)) As Integer

Parametry

chars

ReadOnlySpan<Char>

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

bytes

Span<Byte>

Rozsah obsahující výslednou sadu bajtů.

Návraty

Int32

Skutečný počet bajtů zapsaných do bytes.

Poznámky

Chcete-li vypočítat přesnou velikost potřebnou GetBytes k uložení výsledných bajtů, zavoláte metodu GetByteCount . K výpočtu maximální velikosti voláte metodu GetMaxByteCount . Metoda GetByteCount obecně přiděluje méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.

Při detekci chyb způsobí neplatná posloupnost vyvolání výjimky touto metodou ArgumentException . Bez detekce chyb se ignorují neplatné sekvence a nevyvolá se žádná výjimka.

Data, která se mají převést, například čtení dat ze streamu, můžou být k dispozici pouze v sekvenčních blocích. V tomto případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit do menších bloků, použijte Decoder metodu Encoder nebo metodu vrácenou GetDecoder metodou nebo metodouGetEncoder.

Pokud chcete zajistit, aby se kódované bajty správně dekódovaly, když jsou uloženy jako soubor nebo jako datový proud, můžete předponu datového proudu kódovaných bajtů předponou predikce. Vložení preambule na začátek bajtového proudu (například na začátku řady bajtů, které se mají zapsat do souboru) je zodpovědností vývojáře. Metoda GetBytes nepředá prepend na začátek sekvence zakódovaných bajtů.

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

Zdroj:

UTF8Encoding.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Zakóduje sadu znaků začínající zadaným ukazatelem znaků do posloupnosti bajtů, které jsou uloženy od zadaného bajtového ukazatele.

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

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

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

Parametry

chars

Char*

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

charCount

Int32

Počet znaků, které se mají zakódovat.

bytes

Byte*

Ukazatel na umístění, ve kterém chcete začít psát výslednou sekvenci bajtů.

byteCount

Int32

Maximální počet bajtů k zápisu.

Návraty

Int32

Skutečný počet bajtů zapsaných v místě určeném bytes.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

chars je null.

nebo

bytes je null.

ArgumentOutOfRangeException

charCount nebo byteCount je menší než nula.

ArgumentException

Detekce chyb je povolená a chars obsahuje neplatnou posloupnost znaků.

nebo

byteCount je menší než výsledný počet bajtů.

EncoderFallbackException

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

a

EncoderFallback je nastaveno na EncoderExceptionFallback.

Poznámky

Pokud chcete vypočítat přesnou velikost pole potřebnou GetBytes k uložení výsledných bajtů, zavolejte metodu GetByteCount . Chcete-li vypočítat maximální velikost pole, zavoláte metodu GetMaxByteCount . Metoda GetByteCount obecně přiděluje méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.

Při detekci chyb způsobí neplatná posloupnost vyvolání výjimky touto metodou ArgumentException . Bez detekce chyb se ignorují neplatné sekvence a nevyvolá se žádná výjimka.

Data, která se mají převést, například čtení dat ze streamu, můžou být k dispozici pouze v sekvenčních blocích. V tomto případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit do menších bloků, použijte Decoder metodu Encoder nebo metodu vrácenou GetDecoder metodou nebo metodouGetEncoder.

Pokud chcete zajistit, aby se kódované bajty správně dekódovaly, když jsou uloženy jako soubor nebo jako datový proud, můžete předponu datového proudu kódovaných bajtů předponou predikce. Vložení preambule na začátek bajtového proudu (například na začátku řady bajtů, které se mají zapsat do souboru) je zodpovědností vývojáře. Metoda GetBytes nepředá prepend na začátek sekvence zakódovaných bajtů.

Viz také

• GetEncoder()
• GetByteCount(Char[], Int32, Int32)
• GetMaxByteCount(Int32)

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

Zdroj:

UTF8Encoding.cs

Zakóduje sadu znaků ze zadaného pole znaků do zadaného bajtového pole.

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

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

override this.GetBytes : char[] * int * int * byte[] * int -> int

Public Overrides Function GetBytes (chars As Char(), charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Parametry

chars

Char[]

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

charIndex

Int32

Index prvního znaku, který se má kódovat.

charCount

Int32

Počet znaků, které se mají zakódovat.

bytes

Byte[]

Bajtové pole, které bude obsahovat výslednou sekvenci bajtů.

byteIndex

Int32

Index, na kterém chcete začít psát výslednou sekvenci bajtů.

Návraty

Int32

Skutečný počet bajtů zapsaných do bytes.

Výjimky

ArgumentNullException

chars je null.

nebo

bytes je null.

ArgumentOutOfRangeException

charIndex nebo charCountbyteIndex je menší než nula.

nebo

charIndex a charCount neoznamujte platný rozsah v chars.

nebo

byteIndex není platný index v bytessouboru .

ArgumentException

Detekce chyb je povolená a chars obsahuje neplatnou posloupnost znaků.

nebo

bytes nemá dostatečnou kapacitu od byteIndex konce pole pro přizpůsobení výsledných bajtů.

EncoderFallbackException

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

a

EncoderFallback je nastaveno na EncoderExceptionFallback.

Příklady

Následující příklad používá metodu GetBytes ke kódování rozsahu znaků z řetězce a ukládá kódované bajty v rozsahu prvků v bajtovém poli.

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "UTF8 Encoding Example";
        
        UTF8Encoding utf8 = new UTF8Encoding();
        
        int byteCount = utf8.GetByteCount(chars.ToCharArray(), 0, 13);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf8.GetBytes(chars, 0, 13, bytes, 0);
        
        Console.WriteLine(
            "{0} bytes used to encode string.", bytesEncodedCount
        );

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

Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "UTF8 Encoding Example"
        
        Dim utf8 As New UTF8Encoding()
        
        Dim byteCount As Integer = utf8.GetByteCount(chars.ToCharArray(), 0, 13)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf8.GetBytes(chars, 0, 13, bytes, 0)
        
        Console.WriteLine("{0} bytes used to encode string.", 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

Poznámky

Pokud chcete vypočítat přesnou velikost pole potřebnou GetBytes k uložení výsledných bajtů, zavolejte metodu GetByteCount . Chcete-li vypočítat maximální velikost pole, zavoláte metodu GetMaxByteCount . Metoda GetByteCount obecně přiděluje méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.

Při detekci chyb způsobí neplatná posloupnost vyvolání výjimky touto metodou ArgumentException . Bez detekce chyb se ignorují neplatné sekvence a nevyvolá se žádná výjimka.

Data, která se mají převést, například čtení dat ze streamu, můžou být k dispozici pouze v sekvenčních blocích. V tomto případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, použijte DecoderEncoder metodu GetDecoder nebo metodu nebo metodu GetEncoder .

Pokud chcete zajistit, aby se kódované bajty správně dekódovaly, když jsou uloženy jako soubor nebo jako datový proud, můžete předponu datového proudu kódovaných bajtů předponou predikce. Vložení preambule na začátek bajtového proudu (například na začátku řady bajtů, které se mají zapsat do souboru) je zodpovědností vývojáře. Metoda GetBytes nepředá prepend na začátek sekvence zakódovaných bajtů.

Viz také

• GetEncoder()
• GetByteCount(Char[], Int32, Int32)
• GetMaxByteCount(Int32)

GetBytes(String, Int32, Int32, Byte[], Int32)

Zdroj:

UTF8Encoding.cs

Zakóduje sadu znaků ze zadaného String pole bajtů.

public:
 override int GetBytes(System::String ^ s, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);

public override int GetBytes(string s, int charIndex, int charCount, byte[] bytes, int byteIndex);

override this.GetBytes : string * int * int * byte[] * int -> int

Public Overrides Function GetBytes (s As String, charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Parametry

s

String

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

charIndex

Int32

Index prvního znaku, který se má kódovat.

charCount

Int32

Počet znaků, které se mají zakódovat.

bytes

Byte[]

Bajtové pole, které bude obsahovat výslednou sekvenci bajtů.

byteIndex

Int32

Index, na kterém chcete začít psát výslednou sekvenci bajtů.

Návraty

Int32

Skutečný počet bajtů zapsaných do bytes.

Výjimky

ArgumentNullException

s je null.

nebo

bytes je null.

ArgumentOutOfRangeException

charIndex nebo charCountbyteIndex je menší než nula.

nebo

charIndex a charCount neoznamujte platný rozsah v s.

nebo

byteIndex není platný index v bytessouboru .

ArgumentException

Detekce chyb je povolená a s obsahuje neplatnou posloupnost znaků.

nebo

bytes nemá dostatečnou kapacitu od byteIndex konce pole pro přizpůsobení výsledných bajtů.

EncoderFallbackException

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

a

EncoderFallback je nastaveno na EncoderExceptionFallback.

Příklady

Následující příklad používá metodu GetBytes ke kódování rozsahu prvků z pole znaků Unicode a uložení zakódovaných bajtů v rozsahu prvků v bajtovém poli.

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UTF8Encoding utf8 = new UTF8Encoding();
        
        int byteCount = utf8.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf8.GetBytes(chars, 1, 2, bytes, 0);
        
        Console.WriteLine(
            "{0} bytes used to encode characters.", bytesEncodedCount
        );

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

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF8EncodingExample
    
    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 utf8 As New UTF8Encoding()
        
        Dim byteCount As Integer = utf8.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf8.GetBytes(chars, 1, 2, bytes, 0)
        
        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

Poznámky

Pokud chcete vypočítat přesnou velikost pole potřebnou GetBytes k uložení výsledných bajtů, zavolejte metodu GetByteCount . Chcete-li vypočítat maximální velikost pole, zavoláte metodu GetMaxByteCount . Metoda GetByteCount obecně přiděluje méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.

Při detekci chyb způsobí neplatná posloupnost vyvolání výjimky touto metodou ArgumentException . Bez detekce chyb se ignorují neplatné sekvence a nevyvolá se žádná výjimka.

Data, která se mají převést, například čtení dat ze streamu, můžou být k dispozici pouze v sekvenčních blocích. V tomto případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, použijte DecoderEncoder metodu GetDecoder nebo metodu nebo metodu GetEncoder .

Pokud chcete zajistit, aby se kódované bajty správně dekódovaly, když jsou uloženy jako soubor nebo jako datový proud, můžete předponu datového proudu kódovaných bajtů předponou predikce. Vložení preambule na začátek bajtového proudu (například na začátku řady bajtů, které se mají zapsat do souboru) je zodpovědností vývojáře. Metoda GetBytes nepředá prepend na začátek sekvence zakódovaných bajtů.

Viz také

• GetEncoder()
• GetByteCount(Char[], Int32, Int32)
• GetMaxByteCount(Int32)