ASCIIEncoding.GetBytes Metoda

Definice

Obor názvů:: System.Text

Sestavení:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Sestavení:: mscorlib.dll

Sestavení:: System.Text.Encoding.Extensions.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zakóduje sadu znaků do posloupnosti bajtů.

Přetížení

Name	Description
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(Char, Int32, Byte, Int32)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Alternativa odpovídající specifikaci CLS: System.Text.ASCIIEncoding.GetBytes(Char[], Int32, 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.

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

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

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

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

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

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

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

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

[<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 SecurityCriticalAttribute ComVisibleAttribute

Výjimky

ArgumentNullException

chars je null.

nebo

bytes je null.

ArgumentOutOfRangeException

charCount nebo byteCount je menší než nula.

ArgumentException

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).

EncoderFallback je nastaveno na EncoderExceptionFallback.

Poznámky

K výpočtu přesné velikosti pole vyžadované GetBytes k uložení výsledných bajtů používá GetByteCountaplikace . K výpočtu maximální velikosti pole by aplikace měla použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení menší paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.

Data, která se mají převést, například data načtená ze streamu, mohou 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, měla by aplikace použít Decoder metodu GetDecoder nebo Encoder metodu nebo metoduGetEncoder.

ASCIIEncoding neposkytuje detekci chyb. Jakýkoli znak Unicode větší než U+007F se přeloží na otazník ASCII ("?").

Caution

Z bezpečnostníchdůvodůch UTF8Encoding UnicodeEncoding UTF32Encoding

Viz také

Platí pro

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

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

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).

EncoderFallback je nastaveno na EncoderExceptionFallback.

Příklady

Následující příklad ukazuje, jak pomocí GetBytes metody kódovat rozsah znaků z řetězce a uložit kódované znaky do rozsahu prvků v bajtovém poli.

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "ASCII Encoding Example";
        
        ASCIIEncoding ascii = new ASCIIEncoding();
        
        int byteCount = ascii.GetByteCount(chars.ToCharArray(), 6, 8);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = ascii.GetBytes(chars, 6, 8, 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 ASCIIEncodingExample
   
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "ASCII Encoding Example"

        Dim ascii As New ASCIIEncoding()

        Dim byteCount As Integer = ascii.GetByteCount(chars.ToCharArray(), 6, 8)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = ascii.GetBytes(chars, 6, 8, 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

ASCIIEncoding neposkytuje detekci chyb. Jakýkoli znak Unicode větší než U+007F je kódován jako otazník ASCII ("?").

Caution

Z bezpečnostníchdůvodůch UTF8Encoding UnicodeEncoding UTF32Encoding

Viz také

Platí pro

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

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

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

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

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

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

Parametry

chars: String

Sada znaků, které se mají zakó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 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

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).

EncoderFallback je nastaveno na EncoderExceptionFallback.

Příklady

Následující příklad ukazuje, jak pomocí GetBytes metody kódovat rozsah prvků z pole znaků Unicode a uložit kódované bajty v oblasti prvků v bajtovém poli.

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        ASCIIEncoding ascii = new ASCIIEncoding();
        
        int byteCount = ascii.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = ascii.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 ASCIIEncodingExample
    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 ascii As New ASCIIEncoding()

        Dim byteCount As Integer = ascii.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1){}
        Dim bytesEncodedCount As Integer = ascii.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

ASCIIEncoding neposkytuje detekci chyb. Jakýkoli znak Unicode větší než U+007F je kódován jako otazník ASCII ("?").

Caution

Z bezpečnostních důvodů se doporučuje používat UTF8Encoding, UnicodeEncodingnebo UTF32Encoding povolit detekci chyb.

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?

ASCIIEncoding.GetBytes Metoda

Definice

Přetížení

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

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Váš názor

GetBytes(Char, Int32, Byte, Int32)