ASCIIEncoding.GetChars Metoda

Definice

Obor názvů:

System.Text

Sestavení:

System.Text.Encoding.Extensions.dll

Dekóduje posloupnost bajtů do sady znaků.

Přetížení

GetChars(ReadOnlySpan<Byte>, Span<Char>)	Dekóduje zadaný rozsah bajtů do zadaného rozsahu znaků.
GetChars(Byte*, Int32, Char*, Int32)	Dekóduje posloupnost bajtů začínající od zadaného ukazatele bajtů do sady znaků, které jsou uloženy od zadaného znakového ukazatele.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Dekóduje posloupnost bajtů ze zadaného pole bajtů do zadaného pole znaků.

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

Zdroj:

ASCIIEncoding.cs

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

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

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

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

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

Parametry

bytes

ReadOnlySpan<Byte>

Rozsah obsahující bajty, které se mají dekódovat.

chars

Span<Char>

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

Návraty

Int32

Skutečný počet znaků zapsaných do chars.

Poznámky

Pokud chcete vypočítat přesnou velikost potřebnou GetChars k uložení výsledných znaků, použijte GetCharCount. K výpočtu maximální velikosti použijte GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení menší paměti, zatímco GetMaxCharCount metoda se obecně spouští 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, měli byste použít Decoder nebo , který GetDecoder poskytuje metoda nebo GetEncoderEncoder metoda.

ASCIIEncoding neposkytuje detekci chyb. Libovolný bajt větší než hexadecimální 0x7F se dekóduje jako otazník Unicode ("?").

Upozornění

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

GetChars(Byte*, Int32, Char*, Int32)

Zdroj:

ASCIIEncoding.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Alternativa odpovídající specifikaci CLS

System.Text.ASCIIEncoding.GetChars(Byte[], Int32, Int32, Char[], Int32)

Dekóduje posloupnost bajtů začínající od zadaného ukazatele bajtů do sady znaků, které jsou uloženy od zadaného znakového ukazatele.

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

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

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

Parametry

bytes

Byte*

Ukazatel na první bajt k dekódování.

byteCount

Int32

Počet bajtů k dekódování.

chars

Char*

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

charCount

Int32

Maximální počet znaků, které se mají napsat.

Návraty

Int32

Skutečný počet znaků napsaných na místě označeném znakem chars.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

bytes je null.

-nebo-

chars je null.

ArgumentOutOfRangeException

byteCount nebo charCount je menší než nula.

ArgumentException

charCount je menší než výsledný počet znaků.

DecoderFallbackException

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

-A-

DecoderFallback je nastavená na DecoderExceptionFallbackhodnotu .

Poznámky

K výpočtu přesné velikosti pole potřebné GetChars k uložení výsledných znaků aplikace používá GetCharCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení menší paměti, zatímco GetMaxCharCount metoda se obecně spouští 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, měla by aplikace použít metodu Decoder nebo Encoder metodu, která je poskytována GetDecoder metodou GetEncoder v uvedeném pořadí.

ASCIIEncoding neposkytuje detekci chyb. Jakýkoli bajt větší než hexadecimální 0x7F je dekódován jako otazník Unicode ("?").

Upozornění

Z bezpečnostních důvodů se doporučuje, aby vaše aplikace používala UTF8Encoding, UnicodeEncodingnebo UTF32Encoding a povolila detekci chyb.

Viz také

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)

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

Zdroj:

ASCIIEncoding.cs

Dekóduje posloupnost bajtů ze zadaného pole bajtů do zadaného pole znaků.

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

public override int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

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

Public Overrides Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

Parametry

bytes

Byte[]

Pole bajtů obsahující posloupnost bajtů k dekódování.

byteIndex

Int32

Index prvního bajtu k dekódování.

byteCount

Int32

Počet bajtů k dekódování.

chars

Char[]

Pole znaků, které má obsahovat výslednou sadu znaků.

charIndex

Int32

Index, ve kterém chcete začít psát výslednou sadu znaků.

Návraty

Int32

Skutečný počet znaků zapsaných do chars.

Výjimky

ArgumentNullException

bytes je null.

-nebo-

chars je null.

ArgumentOutOfRangeException

byteIndex nebo byteCountcharIndex je menší než nula.

-nebo-

byteindex a byteCount neoznamují platnou oblast v bytessouboru .

-nebo-

charIndex není platný index v nástroji chars.

ArgumentException

chars nemá dostatečnou kapacitu od charIndex do konce pole pro umístění výsledných znaků.

DecoderFallbackException

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

-A-

DecoderFallback je nastavená na DecoderExceptionFallbackhodnotu .

Příklady

Následující příklad ukazuje, jak dekódovat rozsah prvků z pole bajtů a uložit výsledek v sadě prvků v matici znaků Unicode.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {65,83,67,73,73,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int charCount = ascii->GetCharCount( bytes, 6, 8 );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = ascii->GetChars( bytes, 6, 8, chars, 0 );
   Console::WriteLine( "{0} characters used to decode bytes.", charsDecodedCount );
   Console::Write( "Decoded chars: " );
   IEnumerator^ myEnum = chars->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c = safe_cast<Char>(myEnum->Current);
      Console::Write( "[{0}]", c.ToString() );
   }

   Console::WriteLine();
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             65,  83,  67,  73,  73,  32,  69,
            110,  99, 111, 100, 105, 110, 103,
             32,  69, 120,  97, 109, 112, 108, 101
        };

        ASCIIEncoding ascii = new ASCIIEncoding();

        int charCount = ascii.GetCharCount(bytes, 6, 8);
        chars = new Char[charCount];
        int charsDecodedCount = ascii.GetChars(bytes, 6, 8, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
             65,  83,  67,  73,  73,  32,  69, _
            110,  99, 111, 100, 105, 110, 103, _
             32,  69, 120,  97, 109, 112, 108, 101}

        Dim ascii As New ASCIIEncoding()

        Dim charCount As Integer = ascii.GetCharCount(bytes, 6, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = ascii.GetChars(bytes, 6, 8, chars, 0)

        Console.WriteLine("{0} characters used to decode bytes.", charsDecodedCount)

        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

Poznámky

K výpočtu přesné velikosti pole potřebné GetChars k uložení výsledných znaků aplikace používá GetCharCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení menší paměti, zatímco GetMaxCharCount metoda se obecně spouští 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, měla by aplikace použít metodu Decoder nebo Encoder metodu, která je poskytována GetDecoder metodou GetEncoder v uvedeném pořadí.

ASCIIEncoding neposkytuje detekci chyb. Jakýkoli bajt větší než hexadecimální 0x7F je dekódován jako otazník Unicode ("?").

Upozornění

Z bezpečnostních důvodů se doporučuje, aby vaše aplikace používala UTF8Encoding, UnicodeEncodingnebo UTF32Encoding a povolila detekci chyb.

Viz také

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)