UnicodeEncoding.GetBytes Metoda

Definice

Obor názvů:

System.Text

Sestavení:

System.Text.Encoding.Extensions.dll

Zakóduje sadu znaků do posloupnosti bajtů.

Přetížení

GetBytes(Char[], Int32, Int32, Byte[], Int32)	Zakóduje sadu znaků ze zadaného pole znaků do zadaného pole bajtů.
GetBytes(String, Int32, Int32, Byte[], Int32)	Zakóduje sadu znaků ze zadaného String pole bajtů.
GetBytes(Char*, Int32, Byte*, Int32)	Zakóduje sadu znaků počínaje zadaným znakovým ukazatelem do posloupnosti bajtů, které jsou uloženy počínaje zadaným bajtovým ukazatelem.

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

Zdroj:

UnicodeEncoding.cs

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

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

charIndex

Int32

Index prvního znaku, který se má zakódovat.

charCount

Int32

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

bytes

Byte[]

Pole bajtů, které bude obsahovat výslednou sekvenci bajtů.

byteIndex

Int32

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

Návraty

Int32

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

Výjimky

ArgumentNullException

chars je null (Nothing).

-nebo-

bytes je null (Nothing).

ArgumentOutOfRangeException

charIndex nebo charCountbyteIndex je menší než nula.

-nebo-

charIndex a charCount neoznamujte platnou oblast v charssouboru .

-nebo-

byteIndex není platný index v nástroji bytes.

ArgumentException

Detekce chyb je povolená a chars obsahuje neplatnou posloupnost znaků.

-nebo-

bytes nemá dostatečnou kapacitu od byteIndex konce pole pro uložení výsledných bajtů.

EncoderFallbackException

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

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Příklady

Následující příklad ukazuje, jak použít metodu GetBytes ke kódování rozsahu znaků z String a uložení zakódovaných bajtů v oblasti prvků v bajtovém poli.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Byte>^bytes;
   String^ chars = "Unicode Encoding Example";
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int byteCount = Unicode->GetByteCount( chars->ToCharArray(), 8, 8 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = Unicode->GetBytes( chars, 8, 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 UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "Unicode Encoding Example";
        
        UnicodeEncoding Unicode = new UnicodeEncoding();
        
        int byteCount = Unicode.GetByteCount(chars.ToCharArray(), 8, 8);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = Unicode.GetBytes(chars, 8, 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 UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "Unicode Encoding Example"
        
        Dim uni As New UnicodeEncoding()
        
        Dim byteCount As Integer = uni.GetByteCount(chars.ToCharArray(), 8, 8)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = uni.GetBytes(chars, 8, 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

Pokud chcete vypočítat přesnou velikost pole vyžadovanou GetBytes pro uložení výsledných bajtů, zavoláte metodu GetByteCount . Pokud chcete vypočítat maximální velikost pole, zavolejte metodu GetMaxByteCount . Metoda GetByteCount obecně přiděluje méně paměti, zatímco GetMaxByteCount metoda obecně provádí rychleji.

Při detekci chyb způsobí neplatná sekvence, že tato metoda vyvolá ArgumentExceptionchybu . Bez detekce chyb se neplatné sekvence ignorují a nedochází k žádné výjimce.

Data, která se mají převést, například data přečtená ze streamu, můžou 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 do menších bloků, měla by aplikace použít Decoder metodu nebo EncoderGetDecoder metodu nebo metodu GetEncoder .

Důležité

Pokud chcete zajistit, aby se zakódované bajty správně dekódovaly, když jsou uloženy jako soubor nebo jako datový proud, můžete před datový proud kódovaných bajtů vytvořit předponu preambule. Vložení preambule na začátek datového proudu bajtů (například na začátku řady bajtů, které se mají zapsat do souboru) je odpovědností vývojáře. Metoda GetBytes nepředkládá preambuli na začátek posloupnosti zakódovaných bajtů.

Viz také

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

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

Zdroj:

UnicodeEncoding.cs

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

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

Parametry

s

String

Řetězec obsahující sadu znaků, které se mají zakódovat.

charIndex

Int32

Index prvního znaku, který se má zakódovat.

charCount

Int32

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

bytes

Byte[]

Pole bajtů, které bude obsahovat výslednou sekvenci bajtů.

byteIndex

Int32

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

Návraty

Int32

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

Výjimky

ArgumentNullException

s je null.

-nebo-

bytes je null (Nothing).

ArgumentOutOfRangeException

charIndex nebo charCountbyteIndex je menší než nula.

-nebo-

charIndex a charCount neoznamujte platnou oblast v charssouboru .

-nebo-

byteIndex není platný index v nástroji bytes.

ArgumentException

Detekce chyb je povolená a s obsahuje neplatnou posloupnost znaků.

-nebo-

bytes nemá dostatečnou kapacitu od byteIndex konce pole pro uložení výsledných bajtů.

EncoderFallbackException

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

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Příklady

Následující příklad ukazuje, jak zakódovat oblast prvků z pole znaků Unicode a uložit zakódované bajty v oblasti elementů 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'};
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int byteCount = Unicode->GetByteCount( chars, 1, 2 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = Unicode->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 UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UnicodeEncoding Unicode = new UnicodeEncoding();
        
        int byteCount = Unicode.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = Unicode.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 UnicodeEncodingExample
    
    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 uni As New UnicodeEncoding()
        
        Dim byteCount As Integer = uni.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = uni.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

Pokud chcete vypočítat přesnou velikost pole vyžadovanou GetBytes pro uložení výsledných bajtů, zavoláte metodu GetByteCount . Pokud chcete vypočítat maximální velikost pole, zavolejte metodu GetMaxByteCount . Metoda GetByteCount obecně přiděluje méně paměti, zatímco GetMaxByteCount metoda obecně provádí rychleji.

Při detekci chyb způsobí neplatná sekvence, že tato metoda vyvolá ArgumentExceptionchybu . Bez detekce chyb se neplatné sekvence ignorují a nedochází k žádné výjimce.

Data, která se mají převést, například data přečtená ze streamu, můžou 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 do menších bloků, měla by aplikace použít Decoder metodu nebo EncoderGetDecoder metodu nebo metodu GetEncoder .

Důležité

Pokud chcete zajistit, aby se zakódované bajty správně dekódovaly, když jsou uloženy jako soubor nebo jako datový proud, můžete před datový proud kódovaných bajtů vytvořit předponu preambule. Vložení preambule na začátek datového proudu bajtů (například na začátku řady bajtů, které se mají zapsat do souboru) je odpovědností vývojáře. Metoda GetBytes nepředkládá preambuli na začátek posloupnosti zakódovaných bajtů.

Viz také

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

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

Zdroj:

UnicodeEncoding.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Zakóduje sadu znaků začínajících na zadaném znakovém ukazateli do posloupnosti bajtů, které jsou uloženy od zadaného ukazatele bajtů.

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

Parametry

chars

Char*

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

charCount

Int32

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

bytes

Byte*

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

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

chars je null (Nothing).

-nebo-

bytes je null (Nothing).

ArgumentOutOfRangeException

charCount nebo byteCount je menší než nula.

ArgumentException

Detekce chyb je povolená a chars obsahuje neplatnou posloupnost znaků.

-nebo-

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

EncoderFallbackException

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

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Poznámky

Pokud chcete vypočítat přesnou velikost pole, která GetBytes vyžaduje uložení výsledných bajtů, zavoláte metodu GetByteCount . Pokud chcete vypočítat maximální velikost pole, zavolejte metodu GetMaxByteCount . Metoda GetByteCount obecně přiděluje méně paměti, zatímco GetMaxByteCount metoda obecně provádí rychleji.

Při detekci chyb způsobí neplatná sekvence, že tato metoda vyvolá ArgumentExceptionchybu . Bez detekce chyb jsou neplatné sekvence ignorovány a nedojde k žádné výjimce.

Data, která se mají převést, například data přečtená z datového proudu, můžou 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 Decoder objekt nebo Encoder poskytnutý metodou GetDecoder nebo GetEncoder .

Důležité

Pokud chcete zajistit, aby se kódované bajty při uložení jako souboru nebo datového proudu správně dekódovaly, můžete před datový proud kódovaných bajtů zadat preambuli. Vložení preambule na začátek proudu bajtů (například na začátek řady bajtů, které se mají zapsat do souboru) je zodpovědností vývojáře. Metoda GetBytes nepředkládá preambuli na začátek posloupnosti zakódovaných bajtů.

Viz také

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