UTF7Encoding.GetBytes Metoda

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

Zakóduje sadu znaků do posloupnosti bajtů.

Přetížení

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 do zadaného bajtového pole.

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

CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Výjimky

ArgumentNullException

chars je null (Nothing).

-nebo- bytes je null (Nothing).

ArgumentOutOfRangeException

charCount nebo byteCount je menší než nula.

ArgumentException

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

EncoderFallbackException

Došlo k záložnímu kódu (viz Kódování znaků v .NET , kde najdete úplné vysvětlení).

-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á ze streamu, můžou být dostupná jenom 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.

Poznámka

UTF7Encoding neposkytuje detekci chyb. Neplatné znaky jsou kódovány jako změněný základní znak 64. Z bezpečnostních důvodů se doporučuje používat UTF8Encodingaplikace , UnicodeEncodingnebo UTF32Encoding povolit detekci chyb.

Viz také

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

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 začnete psát výslednou sekvenci bajtů.

Návraty

Int32

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

Výjimky

ArgumentNullException

chars is null (Nothing).

-nebo- bytes is null (Nothing).

ArgumentOutOfRangeException

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

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

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

ArgumentException

bytes nemá dostatečnou kapacitu od byteIndex konce pole, aby vyhovovala výsledným bajtům.

EncoderFallbackException

Došlo k záložnímu kódu (viz Kódování znaků v .NET , kde najdete úplné vysvětlení).

-a- EncoderFallback je nastavena na EncoderExceptionFallbackhodnotu .

Příklady

Následující příklad kódu 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;
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int byteCount = utf7->GetByteCount( chars, 1, 2 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = utf7->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 UTF7EncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UTF7Encoding utf7 = new UTF7Encoding();
        
        int byteCount = utf7.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf7.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 UTF7EncodingExample
    
    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 utf7 As New UTF7Encoding()
        
        Dim byteCount As Integer = utf7.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf7.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í menší paměti, zatímco GetMaxByteCount 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. Neplatné znaky jsou zakódovány jako upravený základní znak 64. Z bezpečnostních důvodů se doporučuje používat UTF8Encodingaplikace , UnicodeEncodingnebo UTF32Encoding povolit detekci chyb.

Viz také

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

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);

[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (string s, int charIndex, int charCount, byte[] bytes, int byteIndex);

override this.GetBytes : string * int * int * byte[] * int -> int

[<System.Runtime.InteropServices.ComVisible(false)>]
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

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 začnete psát výslednou sekvenci bajtů.

Návraty

Int32

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

Atributy

ComVisibleAttribute

Výjimky

ArgumentNullException

s is null (Nothing).

-nebo- bytes is null (Nothing).

ArgumentOutOfRangeException

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

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

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

ArgumentException

bytes nemá dostatečnou kapacitu od byteIndex konce pole, aby vyhovovala výsledným bajtům.

EncoderFallbackException

Došlo k záložnímu kódu (viz Kódování znaků v .NET , kde najdete úplné vysvětlení).

-a- EncoderFallback je nastavena na EncoderExceptionFallbackhodnotu .

Příklady

Následující příklad kódu ukazuje, jak pomocí GetBytes metody 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'};
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int byteCount = utf7->GetByteCount( chars, 1, 2 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = utf7->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 UTF7EncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UTF7Encoding utf7 = new UTF7Encoding();
        
        int byteCount = utf7.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf7.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 UTF7EncodingExample
    
    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 utf7 As New UTF7Encoding()
        
        Dim byteCount As Integer = utf7.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf7.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í menší paměti, zatímco GetMaxByteCount 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. Neplatné znaky jsou zakódovány jako upravený základní znak 64. Z bezpečnostních důvodů se doporučuje používat UTF8Encodingaplikace , UnicodeEncodingnebo UTF32Encoding povolit detekci chyb.

Viz také

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