Sdílet prostřednictvím

UTF7Encoding.GetBytes 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

Zakóduje sadu znaků do posloupnosti bajtů.

Přetížení

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

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

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

Zdroj:
UTF7Encoding.cs
Zdroj:
UTF7Encoding.cs
Zdroj:
UTF7Encoding.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)]
[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á zakódovat.

charCount
Int32

Počet znaků, které mají být zakódovány.

bytes
Byte*

Ukazatel na umístění, ve kterém chcete začít psát výslednou posloupnost 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 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 náhradnímu použití (podrobnější vysvětlení najdete v tématu Kódování znaků v .NET ).

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Poznámky

K výpočtu přesné velikosti pole potřebné GetBytes k uložení výsledných bajtů aplikace používá GetByteCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení menší paměti, zatímco GetMaxByteCount metoda se obecně spouští rychleji.

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 metodu Decoder nebo Encoder metodu, která je poskytována GetDecoder metodou GetEncoder v uvedeném pořadí.

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, aby aplikace používaly UTF8Encoding, UnicodeEncodingnebo UTF32Encoding a povolily detekci chyb.

Viz také

Platí pro

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

Zdroj:
UTF7Encoding.cs
Zdroj:
UTF7Encoding.cs
Zdroj:
UTF7Encoding.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ý má být kódován.

charCount
Int32

Počet znaků, které mají být zakódovány.

bytes
Byte[]

Bajtové pole, které bude obsahovat výslednou posloupnost bajtů.

byteIndex
Int32

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

Návraty

Int32

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

Výjimky

ArgumentNullException

chars je null (Nothing).

-nebo-

bytes je null (Nothing).

ArgumentOutOfRangeException

charIndex nebo charCountbyteIndex je menší než nula.

-nebo-

charIndex a charCount neoznamují platnou oblast v charssouboru .

-nebo-

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

ArgumentException

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

EncoderFallbackException

Došlo k náhradnímu použití (podrobnější vysvětlení najdete v tématu Kódování znaků v .NET ).

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Příklady

Následující příklad kódu ukazuje, jak použít metodu GetBytes kódování rozsah znaků z String a uložit kódované bajty v rozsahu prvků v bajtové pole.

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 potřebné GetBytes k uložení výsledných bajtů aplikace používá GetByteCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení menší paměti, zatímco GetMaxByteCount metoda se obecně spouští rychleji.

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 metodu Decoder nebo Encoder metodu, která je poskytována GetDecoder metodou GetEncoder v uvedeném pořadí.

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, aby aplikace používaly UTF8Encoding, UnicodeEncodingnebo UTF32Encoding a povolily detekci chyb.

Viz také

Platí pro

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

Zdroj:
UTF7Encoding.cs
Zdroj:
UTF7Encoding.cs
Zdroj:
UTF7Encoding.cs

Zakóduje sadu znaků ze zadaného String pole do zadaného 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);
[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

Obsahující String sadu znaků, které se mají kódovat.

charIndex
Int32

Index prvního znaku, který má být kódován.

charCount
Int32

Počet znaků, které mají být zakódovány.

bytes
Byte[]

Bajtové pole, které bude obsahovat výslednou posloupnost bajtů.

byteIndex
Int32

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

Návraty

Int32

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

Atributy
ComVisibleAttribute

Výjimky

ArgumentNullException

s je null (Nothing).

-nebo-

bytes je null (Nothing).

ArgumentOutOfRangeException

charIndex nebo charCountbyteIndex je menší než nula.

-nebo-

charIndex a charCount neoznamují platnou oblast v charssouboru .

-nebo-

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

ArgumentException

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

EncoderFallbackException

Došlo k náhradnímu použití (podrobnější vysvětlení najdete v tématu Kódování znaků v .NET ).

-A-

EncoderFallback je nastavená na EncoderExceptionFallbackhodnotu .

Příklady

Následující příklad kódu ukazuje, jak použít metodu GetBytes kódování rozsah elementů z pole znaků Unicode a uložit kódované bajty v rozsahu prvků v bajtové pole.

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 potřebné GetBytes k uložení výsledných bajtů aplikace používá GetByteCount. K výpočtu maximální velikosti pole by aplikace měla použít GetMaxByteCount. Metoda GetByteCount obecně umožňuje přidělení menší paměti, zatímco GetMaxByteCount metoda se obecně spouští rychleji.

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 metodu Decoder nebo Encoder metodu, která je poskytována GetDecoder metodou GetEncoder v uvedeném pořadí.

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, aby aplikace používaly UTF8Encoding, UnicodeEncodingnebo UTF32Encoding a povolily detekci chyb.

Viz také

Platí pro