UnicodeEncoding.GetBytes Metoda
Definice
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í
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 do zadaného bajtového pole. |
GetBytes(String) |
Zakóduje sadu znaků ze zadaného řetězce do zadaného pole 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.
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
Skutečný počet bajtů zapsaných do bytes
.
Výjimky
charIndex
nebo charCount
byteIndex
je menší než nula.
-nebo-
charIndex
a charCount
neoznamujte platnou oblast v chars
.
-nebo-
byteIndex
není platný index v bytes
.
Detekce chyb je povolená a chars
obsahuje neplatnou posloupnost znaků.
-nebo-
bytes
nemá dostatečnou kapacitu od byteIndex
konce pole, aby vyhovovala výsledným bajtům.
Došlo k náhradní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 použít metodu GetBytes k 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 potřebnou GetBytes k uložení výsledných bajtů, zavoláte metodu GetByteCount . Pokud chcete vypočítat maximální velikost pole, zavoláte metodu GetMaxByteCount . Metoda GetByteCount obecně přiděluje méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.
Při detekci chyb způsobí neplatná sekvence tuto metodu ArgumentExceptionvyvolá . Bez detekce chyb jsou neplatné sekvence ignorovány a vyvolá se žádná výjimka.
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 .
Důležité
Chcete-li zajistit správné dekódování zakódovaných bajtů při jejich uložení jako souboru nebo jako streamu, můžete předponu datového proudu kódovaných bajtů předponou preambule. Vložení preambule na začátek bajtového streamu (například na začátku řady bajtů, které se mají zapsat do souboru) je zodpovědností vývojáře. Metoda GetBytes nepředkládá preambuli na začátek sekvence zakódovaných bajtů.
Viz také
Platí pro
GetBytes(String, Int32, Int32, Byte[], Int32)
Zakóduje sadu znaků ze zadaného String pole do zadaného bajtového pole.
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ů pro kódování.
- 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 začnete psát výslednou sekvenci bajtů.
Návraty
Skutečný počet bajtů zapsaných do bytes
.
Výjimky
charIndex
nebo charCount
byteIndex
je menší než nula.
-nebo-
charIndex
a charCount
neoznamujte platnou oblast v chars
.
-nebo-
byteIndex
není platný index v bytes
.
Detekce chyb je povolená a s
obsahuje neplatnou posloupnost znaků.
-nebo-
bytes
nemá dostatečnou kapacitu od byteIndex
konce pole, aby vyhovovala výsledným bajtům.
Došlo k náhradní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 kódovat rozsah prvků z pole znaků Unicode a ukládat 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'};
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 potřebnou GetBytes k uložení výsledných bajtů, zavoláte metodu GetByteCount . Pokud chcete vypočítat maximální velikost pole, zavoláte metodu GetMaxByteCount . Metoda GetByteCount obecně přiděluje méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.
Při detekci chyb způsobí neplatná sekvence tuto metodu ArgumentExceptionvyvolá . Bez detekce chyb jsou neplatné sekvence ignorovány a vyvolá se žádná výjimka.
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 .
Důležité
Chcete-li zajistit správné dekódování zakódovaných bajtů při jejich uložení jako souboru nebo jako streamu, můžete předponu datového proudu kódovaných bajtů předponou preambule. Vložení preambule na začátek bajtového streamu (například na začátku řady bajtů, které se mají zapsat do souboru) je zodpovědností vývojáře. Metoda GetBytes nepředkládá preambuli na začátek sekvence zakódovaných bajtů.
Viz také
Platí pro
GetBytes(String)
Zakóduje sadu znaků ze zadaného řetězce do zadaného pole bajtů.
public:
override cli::array <System::Byte> ^ GetBytes(System::String ^ s);
public override byte[] GetBytes (string s);
override this.GetBytes : string -> byte[]
Public Overrides Function GetBytes (s As String) As Byte()
Parametry
- s
- String
Návraty
- Byte[]
Platí pro
GetBytes(Char*, Int32, Byte*, Int32)
Důležité
Toto rozhraní API neodpovídá specifikaci CLS.
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)]
public override int GetBytes (char* chars, int charCount, 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)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<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
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
Skutečný počet bajtů zapsaných v umístění označeném parametrem bytes
.
- Atributy
Výjimky
charCount
nebo byteCount
je menší než nula.
Detekce chyb je povolená a chars
obsahuje neplatnou posloupnost znaků.
-nebo-
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
Chcete-li vypočítat přesnou velikost pole, která GetBytes vyžaduje uložení výsledných bajtů, zavoláte metodu GetByteCount . Chcete-li vypočítat maximální velikost pole, volejte metodu GetMaxByteCount . Metoda GetByteCount obecně přiděluje méně paměti, zatímco GetMaxByteCount metoda obvykle provádí rychleji.
Při detekci chyb způsobí neplatná posloupnost tuto metodu vyvolá .ArgumentException Bez detekce chyb se ignorují neplatné sekvence a nevyvolá se žádná výjimka.
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 na menší bloky, aplikace by měla použít Decoder objekt Encoder nebo objekt poskytnutý metodou GetDecoder nebo metodou GetEncoder .
Důležité
Abyste měli jistotu, že jsou kódované bajty správně dekódované, když jsou uloženy jako soubor nebo jako stream, můžete předponu datového proudu kódovaných bajtů předponovat předponou předponou s kódováním. Vložení odůvodnění na začátek bajtového streamu (například na začátku řady bajtů, které se zapisují do souboru) je zodpovědností vývojáře. Metoda GetBytes nenabídí před začátek sekvence zakódovaných bajtů.