ASCIIEncoding.GetBytes Método

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

[<System.CLSCompliant(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int

Parâmetros

Devoluções

O número real de bytes escritos na localização indicada por bytes.

Atributos

CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Exceções

Observações

Para calcular o tamanho exato do array necessário GetBytes para armazenar os bytes resultantes, a aplicação utiliza GetByteCount. Para calcular o tamanho máximo do array, a aplicação deve usar GetMaxByteCount. O GetByteCount método geralmente permite a alocação de menos memória, enquanto o GetMaxByteCount método geralmente é executado mais rapidamente.

Os dados a converter, como dados lidos de um fluxo, só podem estar disponíveis em blocos sequenciais. Neste caso, ou se a quantidade de dados for tão grande que precisa de ser dividida em blocos mais pequenos, a aplicação deve usar o Decoder ou o Encoder fornecido pelo GetDecoder método ou pelo GetEncoder método, respetivamente.

ASCIIEncoding não fornece deteção de erros. Qualquer carácter Unicode maior que U+007F é traduzido para um ponto de interrogação ASCII ("?").

Ver também

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

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

Devoluções

O número real de bytes escritos em bytes.

Exceções

Exemplos

O exemplo seguinte demonstra como usar o GetBytes método para codificar um conjunto de caracteres a partir de uma cadeia e armazenar os caracteres codificados num conjunto de elementos num array de bytes.

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "ASCII Encoding Example";
        
        ASCIIEncoding ascii = new ASCIIEncoding();
        
        int byteCount = ascii.GetByteCount(chars.ToCharArray(), 6, 8);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = ascii.GetBytes(chars, 6, 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 ASCIIEncodingExample
   
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "ASCII Encoding Example"

        Dim ascii As New ASCIIEncoding()

        Dim byteCount As Integer = ascii.GetByteCount(chars.ToCharArray(), 6, 8)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = ascii.GetBytes(chars, 6, 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

Observações

Para calcular o tamanho exato do array necessário GetBytes para armazenar os bytes resultantes, a aplicação utiliza GetByteCount. Para calcular o tamanho máximo do array, a aplicação deve usar GetMaxByteCount. O GetByteCount método geralmente permite a alocação de menos memória, enquanto o GetMaxByteCount método geralmente é executado mais rapidamente.

Os dados a converter, como dados lidos de um fluxo, só podem estar disponíveis em blocos sequenciais. Neste caso, ou se a quantidade de dados for tão grande que precisa de ser dividida em blocos mais pequenos, a aplicação deve usar o Decoder ou o Encoder fornecido pelo GetDecoder método ou pelo GetEncoder método, respetivamente.

ASCIIEncoding não fornece deteção de erros. Qualquer carácter Unicode maior que U+007F é codificado como o ponto de interrogação ASCII ("?").

Ver também

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

public:
 override int GetBytes(System::String ^ chars, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);

public override int GetBytes(string chars, int charIndex, int charCount, byte[] bytes, int byteIndex);

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

Public Overrides Function GetBytes (chars As String, charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Parâmetros

Devoluções

O número real de bytes escritos em bytes.

Exceções

Exemplos

O exemplo seguinte demonstra como usar o GetBytes método para codificar um conjunto de elementos de um array de caracteres Unicode e armazenar os bytes codificados num intervalo de elementos num array de bytes.

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        ASCIIEncoding ascii = new ASCIIEncoding();
        
        int byteCount = ascii.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = ascii.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 ASCIIEncodingExample
    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 ascii As New ASCIIEncoding()

        Dim byteCount As Integer = ascii.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1){}
        Dim bytesEncodedCount As Integer = ascii.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

Observações

Para calcular o tamanho exato do array necessário GetBytes para armazenar os bytes resultantes, a aplicação utiliza GetByteCount. Para calcular o tamanho máximo do array, a aplicação deve usar GetMaxByteCount. O GetByteCount método geralmente permite a alocação de menos memória, enquanto o GetMaxByteCount método geralmente é executado mais rapidamente.

Os dados a converter, como dados lidos de um fluxo, só podem estar disponíveis em blocos sequenciais. Neste caso, ou se a quantidade de dados for tão grande que precisa de ser dividida em blocos mais pequenos, a aplicação deve usar o Decoder ou o Encoder fornecido pelo GetDecoder método ou pelo GetEncoder método, respetivamente.

ASCIIEncoding não fornece deteção de erros. Qualquer carácter Unicode maior que U+007F é codificado como o ponto de interrogação ASCII ("?").

Ver também

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