ASCIIEncoding.GetBytes Metoda

Definice

Zakóduje sadu znaků do posloupnosti bajtů.

Přetížení

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

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

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

Zakóduje sadu znaků začínající na zadaném ukazateli 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>)

Zakóduje zadaný rozsah 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á kódovat.

bytes
Span<Byte>

Rozsah, který bude obsahovat výslednou sadu bajtů.

Návraty

Int32

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

Poznámky

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

Data, která se mají převést, například data načtená z datového proudu, 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, použijte Decoder metodu GetDecoder nebo metodu nebo Encoder metodu nebo metoduGetEncoder.

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

Upozornění

Z bezpečnostních důvodů byste měli použít UTF8Encoding, UnicodeEncodingnebo UTF32Encoding povolit detekci chyb.

Platí pro

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í na zadaném ukazateli 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)]
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)>]
[<System.Security.SecurityCritical>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
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

Parametry

chars
Char*

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

charCount
Int32

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

bytes
Byte*

Ukazatel na umístění, ve kterém 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 umístění označeném bytes.

Atributy

Výjimky

chars je null.

-nebo- bytes je null.

charCount nebo byteCount je menší než nula.

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

Došlo k záložnímu obnovení (další informace najdete v tématu Kódování znaků v .NET). -a- EncoderFallback je nastavena na EncoderExceptionFallbackhodnotu .

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 měla aplikace použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.

Data, která se mají převést, například data načtená z datového proudu, mohou být k dispozici pouze v sekvenčních blocích. V takovém případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, aplikace by měla 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 ("?").

Upozornění

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

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í kódovat.

bytes
Byte[]

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

byteIndex
Int32

Index, na kterém se má začít psát výsledná posloupnost bajtů.

Návraty

Int32

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

Výjimky

chars je null.

-nebo- bytes je null.

charIndex nebo charCount byteIndex je menší než nula.

-nebo- charIndex a charCount neoznamujte platnou oblast v chars.

-nebo- byteIndex není platný index v bytes.

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

Došlo k záložnímu obnovení (další informace najdete v tématu Kódování znaků v .NET). -a- EncoderFallback je nastavena na EncoderExceptionFallbackhodnotu .

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 namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Byte>^bytes;
   String^ chars = "ASCII Encoding Example";
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = ascii->GetByteCount( chars->ToCharArray(), 6, 8 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = ascii->GetBytes( chars, 6, 8, bytes, 0 );
   Console::WriteLine( " {0} bytes used to encode string.", bytesEncodedCount );
   Console::Write( "Encoded bytes: " );
   IEnumerator^ myEnum = bytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
}
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

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 měla aplikace použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.

Data, která se mají převést, například data načtená z datového proudu, mohou být k dispozici pouze v sekvenčních blocích. V takovém případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, aplikace by měla použít Decoder metodu GetDecoder nebo Encoder metodu nebo metoduGetEncoder.

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

Upozornění

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

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

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í kódovat.

bytes
Byte[]

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

byteIndex
Int32

Index, na kterém se má začít psát výsledná posloupnost bajtů.

Návraty

Int32

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

Výjimky

s je null.

-nebo- bytes je null.

charIndex nebo charCount byteIndex je menší než nula.

-nebo- charIndex a charCount neoznamujte platnou oblast v chars.

-nebo- byteIndex není platný index v bytes.

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

Došlo k záložnímu obnovení (další informace najdete v tématu Kódování znaků v .NET). -a- EncoderFallback je nastavena na EncoderExceptionFallbackhodnotu .

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 do oblasti prvků v bajtovém poli.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Byte>^bytes;
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = ascii->GetByteCount( chars, 1, 2 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = ascii->GetBytes( chars, 1, 2, bytes, 0 );
   Console::WriteLine( " {0} bytes used to encode characters.", bytesEncodedCount );
   Console::Write( "Encoded bytes: " );
   IEnumerator^ myEnum = bytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
}
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

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 měla aplikace použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.

Data, která se mají převést, například data načtená z datového proudu, mohou být k dispozici pouze v sekvenčních blocích. V takovém případě nebo pokud je množství dat tak velké, že je potřeba je rozdělit na menší bloky, aplikace by měla použít Decoder metodu GetDecoder nebo Encoder metodu nebo metoduGetEncoder.

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

Upozornění

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

Viz také

Platí pro