UTF8Encoding.GetBytes Metódus

Definíció

Névtér:

System.Text

Szerelvények:

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

Egy karakterkészletet bájtok sorozatába kódol.

Túlterhelések

Name	Description
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	A megadott karaktertartományt a megadott bájttartományba kódolja.
GetBytes(Char*, Int32, Byte*, Int32)	A megadott karaktermutatótól kezdődő karakterkészletet bájtok sorozatába kódolja, amelyek a megadott bájtmutatótól kezdve vannak tárolva.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Egy karakterkészletet kódol a megadott karaktertömbből a megadott bájttömbbe.
GetBytes(String, Int32, Int32, Byte[], Int32)	A megadott String bájttömbbe kódol egy karakterkészletet.

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

Forrás:

UTF8Encoding.cs

A megadott karaktertartományt a megadott bájttartományba kódolja.

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

Paraméterek

chars

ReadOnlySpan<Char>

A kódolandó karaktertartomány.

bytes

Span<Byte>

Az eredményként kapott bájtkészletet tartalmazó időtartam.

Válaszok

Int32

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

Megjegyzések

Az eredményként kapott bájtok tárolásához szükséges GetBytes pontos méret kiszámításához hívja meg a metódust GetByteCount . A maximális méret kiszámításához hívja meg a metódust GetMaxByteCount . A GetByteCount metódus általában kevesebb memóriát foglal le, míg a GetMaxByteCount metódus általában gyorsabban fut.

Hibaészlelés esetén az érvénytelen sorrend miatt ez a módszer kivételt ArgumentException okoz. Hibaészlelés nélkül a rendszer figyelmen kívül hagyja az érvénytelen sorozatokat, és nincs kivétel.

Az átalakítandó adatok, például a streamből beolvasott adatok csak szekvenciális blokkokban érhetők el. Ebben az esetben, vagy ha az adatok mennyisége olyan nagy, hogy kisebb blokkokra kell osztani, használja a DecoderEncoder metódus vagy a GetDecoderGetEncoder metódus által visszaadott adatokat.

Annak érdekében, hogy a kódolt bájtok megfelelően legyenek dekódolva, amikor fájlként vagy streamként vannak mentve, előtagként előtagolhatja a kódolt bájtok adatfolyamát egy preambulummal. A bájtfolyam elején (például egy fájlba írandó bájtsor elején) a preambulum beszúrása a fejlesztő feladata. A GetBytes metódus nem előszab előre egy preambulumot a kódolt bájtok sorozatának elejére.

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

Forrás:

UTF8Encoding.cs

Fontos

Ez az API nem CLS-kompatibilis.

A megadott karaktermutatótól kezdődő karakterkészletet bájtok sorozatába kódolja, amelyek a megadott bájtmutatótól kezdve vannak tárolva.

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

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.

Válaszok

Int32

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

Attribútumok

CLSCompliantAttribute

Kivételek

ArgumentNullException

chars az null.

-vagy-

bytes az null.

ArgumentOutOfRangeException

charCount vagy byteCount kisebb, mint nulla.

ArgumentException

A hibaészlelés engedélyezve van, és chars érvénytelen karaktersorozatot tartalmaz.

-vagy-

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-

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

Megjegyzések

Az eredményként kapott bájtok tárolásához szükséges GetBytes pontos tömbméret kiszámításához hívja meg a metódust GetByteCount . A maximális tömbméret kiszámításához hívja meg a metódust GetMaxByteCount . A GetByteCount metódus általában kevesebb memóriát foglal le, míg a GetMaxByteCount metódus általában gyorsabban fut.

Hibaészlelés esetén az érvénytelen sorrend miatt ez a módszer kivételt ArgumentException okoz. Hibaészlelés nélkül a rendszer figyelmen kívül hagyja az érvénytelen sorozatokat, és nincs kivétel.

Az átalakítandó adatok, például a streamből beolvasott adatok csak szekvenciális blokkokban érhetők el. Ebben az esetben, vagy ha az adatok mennyisége olyan nagy, hogy kisebb blokkokra kell osztani, használja a DecoderEncoder metódus vagy a GetDecoderGetEncoder metódus által visszaadott adatokat.

Annak érdekében, hogy a kódolt bájtok megfelelően legyenek dekódolva, amikor fájlként vagy streamként vannak mentve, előtagként előtagolhatja a kódolt bájtok adatfolyamát egy preambulummal. A bájtfolyam elején (például egy fájlba írandó bájtsor elején) a preambulum beszúrása a fejlesztő feladata. A GetBytes metódus nem előszab előre egy preambulumot a kódolt bájtok sorozatának elejére.

Lásd még

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

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

Forrás:

UTF8Encoding.cs

Egy karakterkészletet kódol a megadott karaktertömbből a megadott bájttömbbe.

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

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.

Válaszok

Int32

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

Kivételek

ArgumentNullException

chars az null.

-vagy-

bytes az null.

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

A hibaészlelés engedélyezve van, és chars érvénytelen karaktersorozatot tartalmaz.

-vagy-

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-

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

Példák

Az alábbi példa egy karakterlánc karaktertartományának kódolására szolgál, GetBytes és a bájtokat egy bájttömb elemeinek egy tartományában tárolja.

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

Megjegyzések

Az eredményként kapott bájtok tárolásához szükséges GetBytes pontos tömbméret kiszámításához hívja meg a metódust GetByteCount . A maximális tömbméret kiszámításához hívja meg a metódust GetMaxByteCount . A GetByteCount metódus általában kevesebb memóriát foglal le, míg a GetMaxByteCount metódus általában gyorsabban fut.

Hibaészlelés esetén az érvénytelen sorrend miatt ez a módszer kivételt ArgumentException okoz. Hibaészlelés nélkül a rendszer figyelmen kívül hagyja az érvénytelen sorozatokat, és nincs kivétel.

Az átalakítandó adatok, például a streamből beolvasott adatok csak szekvenciális blokkokban érhetők el. Ebben az esetben, vagy ha az adatok mennyisége olyan nagy, hogy kisebb blokkokra kell osztani, használja a DecoderEncoder metódus vagy a GetDecoder metódus által GetEncoder megadott vagy megadott adatokat.

Annak érdekében, hogy a kódolt bájtok megfelelően legyenek dekódolva, amikor fájlként vagy streamként vannak mentve, előtagként előtagolhatja a kódolt bájtok adatfolyamát egy preambulummal. A bájtfolyam elején (például egy fájlba írandó bájtsor elején) a preambulum beszúrása a fejlesztő feladata. A GetBytes metódus nem előszab előre egy preambulumot a kódolt bájtok sorozatának elejére.

Lásd még

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

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

Forrás:

UTF8Encoding.cs

A megadott String bájttömbbe kódol egy karakterkészletet.

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

Paraméterek

s

String

A String kódolandó karakterkészletet tartalmazó karakterkészlet.

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.

Válaszok

Int32

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

Kivételek

ArgumentNullException

s az null.

-vagy-

bytes az null.

ArgumentOutOfRangeException

charIndex vagy charCountbyteIndex kisebb, mint nulla.

-vagy-

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

-vagy-

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

ArgumentException

A hibaészlelés engedélyezve van, és s érvénytelen karaktersorozatot tartalmaz.

-vagy-

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-

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

Példák

Az alábbi példa egy GetBytes Unicode-karaktertömb elemeinek tartományát kódolja, és a bájtokat egy bájttömb elemeinek tartományában tárolja.

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

Megjegyzések

Az eredményként kapott bájtok tárolásához szükséges GetBytes pontos tömbméret kiszámításához hívja meg a metódust GetByteCount . A maximális tömbméret kiszámításához hívja meg a metódust GetMaxByteCount . A GetByteCount metódus általában kevesebb memóriát foglal le, míg a GetMaxByteCount metódus általában gyorsabban fut.

Hibaészlelés esetén az érvénytelen sorrend miatt ez a módszer kivételt ArgumentException okoz. Hibaészlelés nélkül a rendszer figyelmen kívül hagyja az érvénytelen sorozatokat, és nincs kivétel.

Az átalakítandó adatok, például a streamből beolvasott adatok csak szekvenciális blokkokban érhetők el. Ebben az esetben, vagy ha az adatok mennyisége olyan nagy, hogy kisebb blokkokra kell osztani, használja a DecoderEncoder metódus vagy a GetDecoder metódus által GetEncoder megadott vagy megadott adatokat.

Annak érdekében, hogy a kódolt bájtok megfelelően legyenek dekódolva, amikor fájlként vagy streamként vannak mentve, előtagként előtagolhatja a kódolt bájtok adatfolyamát egy preambulummal. A bájtfolyam elején (például egy fájlba írandó bájtsor elején) a preambulum beszúrása a fejlesztő feladata. A GetBytes metódus nem előszab előre egy preambulumot a kódolt bájtok sorozatának elejére.

Lásd még

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