UTF8Encoding.GetBytes Método

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

Retornos

Uma matriz de bytes que contém os caracteres codificados na cadeia de caracteres especificada pelo parâmetro s.

Origem:

UTF8Encoding.cs

Origem:

UTF8Encoding.cs

Origem:

UTF8Encoding.cs

public:
 override int GetBytes(ReadOnlySpan<char> chars, Span<System::Byte> bytes);

public override int GetBytes (ReadOnlySpan<char> chars, Span<byte> bytes);

override this.GetBytes : ReadOnlySpan<char> * Span<byte> -> int

Public Overrides Function GetBytes (chars As ReadOnlySpan(Of Char), bytes As Span(Of Byte)) As Integer

Parâmetros

Retornos

O número real de bytes gravados no bytes.

Comentários

Para calcular o tamanho exato necessário para GetBytes armazenar os bytes resultantes, chame o GetByteCount método . Para calcular o tamanho máximo, 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 gere uma exceção 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 apenas em blocos sequenciais. Nesse caso, ou se a quantidade de dados for tão grande que precise ser dividida em blocos menores, use o Decoder ou o Encoder retornado pelo método ou pelo GetDecoderGetEncoder método , respectivamente.

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.

Origem:

UTF8Encoding.cs

Origem:

UTF8Encoding.cs

Origem:

UTF8Encoding.cs

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

Parâmetros

Retornos

O número real de bytes gravados no local indicado por bytes.

Atributos

CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Exceções

Comentários

Para calcular o tamanho exato da matriz necessário para GetBytes 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 gere uma exceção 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 apenas em blocos sequenciais. Nesse caso, ou se a quantidade de dados for tão grande que precise ser dividida em blocos menores, use o Decoder ou o Encoder retornado pelo método ou pelo GetDecoderGetEncoder método , respectivamente.

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

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

Origem:

UTF8Encoding.cs

Origem:

UTF8Encoding.cs

Origem:

UTF8Encoding.cs

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

Retornos

O número real de bytes gravados no bytes.

Exceções

Exemplos

O exemplo a seguir usa o GetBytes método para codificar um intervalo de caracteres de uma cadeia de caracteres e armazena 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 = "UTF8 Encoding Example";
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   int byteCount = utf8->GetByteCount( chars->ToCharArray(), 0, 13 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = utf8->GetBytes( chars, 0, 13, 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 UTF8EncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "UTF8 Encoding Example";
        
        UTF8Encoding utf8 = new UTF8Encoding();
        
        int byteCount = utf8.GetByteCount(chars.ToCharArray(), 0, 13);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf8.GetBytes(chars, 0, 13, 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 UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "UTF8 Encoding Example"
        
        Dim utf8 As New UTF8Encoding()
        
        Dim byteCount As Integer = utf8.GetByteCount(chars.ToCharArray(), 0, 13)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf8.GetBytes(chars, 0, 13, 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 para GetBytes 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 gere uma exceção 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 apenas em blocos sequenciais. Nesse caso, ou se a quantidade de dados for tão grande que precise ser dividida em blocos menores, use o Decoder ou o Encoder fornecido pelo GetDecoder método ou pelo GetEncoder método , respectivamente.

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

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

Origem:

UTF8Encoding.cs

Origem:

UTF8Encoding.cs

Origem:

UTF8Encoding.cs

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

Retornos

O número real de bytes gravados no bytes.

Exceções

Exemplos

O exemplo a seguir usa o GetBytes método para 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'};
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   int byteCount = utf8->GetByteCount( chars, 1, 2 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = utf8->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 UTF8EncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UTF8Encoding utf8 = new UTF8Encoding();
        
        int byteCount = utf8.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf8.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 UTF8EncodingExample
    
    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 utf8 As New UTF8Encoding()
        
        Dim byteCount As Integer = utf8.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = utf8.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

Para calcular o tamanho exato da matriz exigido por GetBytes para armazenar os bytes resultantes, chame o GetByteCount método . Para calcular o tamanho máximo da matriz, chame 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 gere uma exceção ArgumentException . Sem a 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 apenas em blocos sequenciais. Nesse caso, ou se a quantidade de dados for tão grande que precise ser dividida em blocos menores, use o Decoder ou o Encoder fornecido pelo GetDecoder método ou pelo GetEncoder método , respectivamente.

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 anexa um preâmbulo ao início de uma sequência de bytes codificados.

Confira também

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