Share via

UTF7Encoding.GetChars Metoda

  • Reference

Definice

Obor názvů:
System.Text
Sestavení:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Sestavení:
System.Text.Encoding.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Dekóduje posloupnost bajtů do sady znaků.

Přetížení

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

Dekóduje posloupnost bajtů počínaje zadaným bajtovým ukazatelem na sadu znaků, které jsou uložené od zadaného ukazatele znaků.
GetChars(Byte[], Int32, Int32, Char[], Int32)

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

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

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Dekóduje posloupnost bajtů počínaje zadaným bajtovým ukazatelem na sadu znaků, které jsou uložené od zadaného ukazatele znaků.

public:
 override int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetChars (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)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int

Parametry

bytes
Byte*

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

byteCount
Int32

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

chars
Char*

Ukazatel na umístění, ve kterém se má začít psát výsledná sada znaků.

charCount
Int32

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

Návraty

Int32

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

Atributy
CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Výjimky

ArgumentNullException

bytes is null (Nothing).

-nebo- chars is null (Nothing).

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 obnovení (další informace najdete v tématu Kódování znaků v .NET). -a- DecoderFallback je nastavena na DecoderExceptionFallbackhodnotu .

Poznámky

Chcete-li vypočítat přesnou velikost pole potřebnou GetChars k uložení výsledných znaků, použijte GetCharCount. K výpočtu maximální velikosti pole by měla aplikace použít GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení menší paměti, zatímco GetMaxCharCount metoda obvykle provádí rychleji.

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

Poznámka

UTF7Encoding neposkytuje detekci chyb. Pokud dojde k neplatnému bajtu, UTF7Encoding obvykle vygeneruje neplatné bajty. Pokud je bajt větší než šestnáctkové 0x7F, je bajtová hodnota nulou rozšířená na znak Unicode, výsledek se uloží do chars pole a všechny sekvence posunu se ukončí. Pokud je například bajt pro kódování šestnáctkový 0x81, výsledný znak je U+0081. Z bezpečnostních důvodů se doporučuje používat UTF8Encodingaplikace , UnicodeEncodingnebo UTF32Encoding povolit detekci chyb.

Viz také

Platí pro

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

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

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[]

Bajtové pole obsahující posloupnost bajtů k dekódování.

byteIndex
Int32

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

byteCount
Int32

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

chars
Char[]

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

charIndex
Int32

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

Návraty

Int32

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

Výjimky

ArgumentNullException

bytes is null (Nothing).

-nebo- chars is null (Nothing).

ArgumentOutOfRangeException

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

-nebo- byteindex a byteCount neoznamujte platnou oblast v bytes.

-nebo- charIndex není platný index v chars.

ArgumentException

chars nemá dostatečnou kapacitu od charIndex konce pole, aby vyhovovala výsledným znakům.

DecoderFallbackException

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

Příklady

Následující příklad kódu ukazuje, jak pomocí GetChars metody dekódovat rozsah prvků v bajtové matici a uložit výsledek do znakové matice.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {85,84,70,55,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int charCount = utf7->GetCharCount( bytes, 2, 8 );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = utf7->GetChars( bytes, 2, 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 UTF7EncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             85,  84,  70,  55,  32,  69, 110,
             99, 111, 100, 105, 110, 103,  32,
             69, 120,  97, 109, 112, 108, 101
        };

        UTF7Encoding utf7 = new UTF7Encoding();

        int charCount = utf7.GetCharCount(bytes, 2, 8);
        chars = new Char[charCount];
        int charsDecodedCount = utf7.GetChars(bytes, 2, 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 UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85,  84,  70,  55,  32,  69, 110, _
            99, 111, 100, 105, 110, 103,  32, _
            69, 120,  97, 109, 112, 108, 101 _
        }
        
        Dim utf7 As New UTF7Encoding()
        
        Dim charCount As Integer = utf7.GetCharCount(bytes, 2, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = utf7.GetChars(bytes, 2, 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

Chcete-li vypočítat přesnou velikost pole potřebnou GetChars k uložení výsledných znaků, použijte GetCharCount. K výpočtu maximální velikosti pole by měla aplikace použít GetMaxCharCount. Metoda GetCharCount obecně umožňuje přidělení menší paměti, zatímco GetMaxCharCount metoda obvykle provádí rychleji.

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

Poznámka

UTF7Encoding neposkytuje detekci chyb. Pokud dojde k neplatnému bajtu, UTF7Encoding obvykle vygeneruje neplatné bajty. Pokud je bajt větší než šestnáctkové 0x7F, je bajtová hodnota nulou rozšířená na znak Unicode, výsledek se uloží do chars pole a všechny sekvence posunu se ukončí. Pokud je například bajt pro kódování šestnáctkový 0x81, výsledný znak je U+0081. Z bezpečnostních důvodů se doporučuje používat UTF8Encodingaplikace , UnicodeEncodingnebo UTF32Encoding povolit detekci chyb.

Viz také

Platí pro