UnicodeEncoding.GetBytes Método

Referência

Definição

Namespace:: System.Text

Assembly:: System.Text.Encoding.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Codifica um conjunto de caracteres em uma sequência de bytes.

Sobrecargas

GetBytes(Char[], Int32, Int32, Byte[], Int32)	Codifica um conjunto de caracteres da matriz de caracteres especificada na matriz de bytes especificada.
GetBytes(String, Int32, Int32, Byte[], Int32)	Codifica um conjunto de caracteres do String especificado para a matriz de bytes especificada.
GetBytes(String)	Codifica um conjunto de caracteres da cadeia de caracteres indicada para a matriz de bytes especificada.
GetBytes(Char, Int32, Byte, Int32)	Codifica um conjunto de caracteres começando no ponteiro de caractere especificado em uma sequência de bytes armazenados começando no ponteiro de byte especificado.

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

Codifica um conjunto de caracteres da matriz de caracteres especificada na matriz de bytes especificada.

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

Parâmetros

chars: Char[]

A matriz de caracteres que contém o conjunto de caracteres a serem codificados.

charIndex: Int32

O índice do primeiro caractere a ser codificado.

charCount: Int32

O número de caracteres a ser codificado.

bytes: Byte[]

A matriz de bytes que conterá a sequência de bytes resultante.

byteIndex: Int32

O índice no qual será iniciada a gravação da sequência de bytes resultante.

Retornos

Int32

O número real de bytes gravados no bytes.

Exceções

ArgumentNullException

chars é null (Nothing).

- ou - bytes é null (Nothing).

ArgumentOutOfRangeException

charIndex, charCount ou byteIndex é menor que zero.

- ou - charIndex e charCount não denotam um intervalo válido em chars.

- ou - byteIndex não é um índice válido em bytes.

ArgumentException

A detecção de erros está habilitada e chars contém uma sequência de caracteres inválida.

- ou - O bytes não tem capacidade suficiente do byteIndex ao final da matriz para acomodar os bytes resultantes.

EncoderFallbackException

Ocorreu um fallback (saiba mais em Codificação de caracteres no .NET) -e- EncoderFallback é definido como EncoderExceptionFallback.

Exemplos

O exemplo a seguir demonstra como usar o GetBytes método para codificar um intervalo de caracteres de um String e armazenar os bytes codificados em um intervalo de elementos em uma matriz de bytes.

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

Comentários

Para calcular o tamanho exato da matriz necessário GetBytes para armazenar os bytes resultantes, chame o GetByteCount método. Para calcular o tamanho máximo da matriz, você chama o GetMaxByteCount método. O GetByteCount método geralmente aloca menos memória, enquanto o GetMaxByteCount método geralmente é executado mais rápido.

Com a detecção de erros, uma sequência inválida faz com que esse método gere um ArgumentException. Sem detecção de erro, sequências inválidas são ignoradas e nenhuma exceção é gerada.

Os dados a serem convertidos, como dados lidos de um fluxo, podem estar disponíveis apenas em blocos sequenciais. Nesse caso, ou se a quantidade de dados é tão grande que precisa ser dividida em blocos menores, o aplicativo deve usar o Decoder método ou GetEncoder o Encoder método GetDecoder fornecido, respectivamente.

Importante

Para garantir que os bytes codificados sejam decodificados corretamente quando forem salvos como um arquivo ou como um fluxo, você pode prefixar um fluxo de bytes codificados com um preâmbulo. Inserir o preâmbulo no início de um fluxo de bytes (como no início de uma série de bytes a serem gravados em um arquivo) é responsabilidade do desenvolvedor. O GetBytes método não prepara um preâmbulo para o início de uma sequência de bytes codificados.

Confira também

Aplica-se a

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

Codifica um conjunto de caracteres do String especificado para a matriz de bytes especificada.

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

Parâmetros

s: String

A cadeia de caracteres que contém o conjunto de caracteres a ser codificado.

charIndex: Int32

O índice do primeiro caractere a ser codificado.

charCount: Int32

O número de caracteres a ser codificado.

bytes: Byte[]

A matriz de bytes que conterá a sequência de bytes resultante.

byteIndex: Int32

O índice no qual será iniciada a gravação da sequência de bytes resultante.

Retornos

Int32

O número real de bytes gravados no bytes.

Exceções

ArgumentNullException

s é null.

- ou - bytes é null (Nothing).

ArgumentOutOfRangeException

charIndex, charCount ou byteIndex é menor que zero.

- ou - charIndex e charCount não denotam um intervalo válido em chars.

- ou - byteIndex não é um índice válido em bytes.

ArgumentException

A detecção de erros está habilitada e s contém uma sequência de caracteres inválida.

- ou - O bytes não tem capacidade suficiente do byteIndex ao final da matriz para acomodar os bytes resultantes.

EncoderFallbackException

Ocorreu um fallback (saiba mais em Codificação de caracteres no .NET) -e- EncoderFallback é definido como EncoderExceptionFallback.

Exemplos

O exemplo a seguir demonstra como codificar um intervalo de elementos de uma matriz de caracteres Unicode e armazenar os bytes codificados em um intervalo de elementos em uma matriz de bytes.

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

Comentários

Com a detecção de erros, uma sequência inválida faz com que esse método gere um ArgumentException. Sem detecção de erro, sequências inválidas são ignoradas e nenhuma exceção é gerada.

Importante

Confira também

Aplica-se a

GetBytes(String)

Codifica um conjunto de caracteres da cadeia de caracteres indicada para a matriz de bytes especificada.

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

Parâmetros

s: String

Retornos

Byte[]

Aplica-se a

GetBytes(Char, Int32, Byte, Int32)

Importante

Esta API não está em conformidade com CLS.

Codifica um conjunto de caracteres começando no ponteiro de caractere especificado em uma sequência de bytes armazenados começando no ponteiro de byte especificado.

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

Parâmetros

chars: Char*

Um ponteiro para o primeiro caractere a ser codificado.

charCount: Int32

O número de caracteres a ser codificado.

bytes: Byte*

Um ponteiro para o local no qual a gravação da sequência de bytes resultante deve ser iniciada.

byteCount: Int32

O número máximo de bytes a serem gravados.

Retornos

Int32

O número real de bytes gravados no local indicado pelo parâmetro bytes.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Exceções

ArgumentNullException

chars é null (Nothing).

- ou - bytes é null (Nothing).

ArgumentOutOfRangeException

charCount ou byteCount é menor que zero.

ArgumentException

A detecção de erros está habilitada e chars contém uma sequência de caracteres inválida.

- ou - byteCount é menor que o número de bytes resultante.

EncoderFallbackException

Ocorreu um fallback (saiba mais em Codificação de caracteres no .NET) -e- EncoderFallback é definido como EncoderExceptionFallback.

Comentários

Para calcular o tamanho exato da matriz que GetBytes requer armazenar os bytes resultantes, chame o GetByteCount método. Para calcular o tamanho máximo da matriz, você chama o GetMaxByteCount método. O GetByteCount método geralmente aloca menos memória, enquanto o GetMaxByteCount método geralmente é executado mais rapidamente.

Com a detecção de erros, uma sequência inválida faz com que esse método lance um ArgumentException. Sem detecção de erros, sequências inválidas são ignoradas e nenhuma exceção é gerada.

Os dados a serem convertidos, como dados lidos de um fluxo, podem estar disponíveis somente em blocos sequenciais. Nesse caso, ou se a quantidade de dados é tão grande que precisa ser dividida em blocos menores, o aplicativo deve usar o objeto ou o Decoder Encoder objeto fornecido pelo método ou GetEncoder pelo GetDecoder método, respectivamente.

Importante

Para garantir que os bytes codificados sejam decodificados corretamente quando são salvos como um arquivo ou como um fluxo, você pode prefixar um fluxo de bytes codificados com um preâmbulo. Inserir o preâmbulo no início de um fluxo de bytes (como no início de uma série de bytes a serem gravados em um arquivo) é responsabilidade do desenvolvedor. O GetBytes método não prepara um preâmbulo para o início de uma sequência de bytes codificados.

Confira também

Aplica-se a

UnicodeEncoding.GetBytes Método

Definição

Sobrecargas

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

GetBytes(String)

Parâmetros

Retornos

Aplica-se a

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

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Recursos adicionais

GetBytes(Char, Int32, Byte, Int32)