UTF7Encoding.GetBytes Método

Definição

Espaço de Nomes:
System.Text
Assemblagens:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Text.Encoding.Extensions.dll
Assemblagem:
netstandard.dll

Codifica um conjunto de caracteres numa sequência de bytes.

Sobrecargas

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

Codifica um conjunto de caracteres a partir do ponteiro especificado numa sequência de bytes que são armazenados a partir do ponteiro especificado.
GetBytes(Char[], Int32, Int32, Byte[], Int32)

Codifica um conjunto de caracteres do array de caracteres especificado no array de bytes especificado.
GetBytes(String, Int32, Int32, Byte[], Int32)

Codifica um conjunto de caracteres do especificado String para o array de bytes especificado.

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

Importante

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

Codifica um conjunto de caracteres a partir do ponteiro especificado numa sequência de bytes que são armazenados a partir do ponteiro especificado.

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

chars
Char*

Um apontador para o primeiro carácter a codificar.

charCount
Int32

O número de caracteres a codificar.

bytes
Byte*

Um apontador para o local onde começar a escrever a sequência resultante de bytes.

byteCount
Int32

O número máximo de bytes a escrever.

Devoluções

Int32

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

Atributos
CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Exceções

ArgumentNullException

chars é null (Nothing).

-ou-

bytes é null (Nothing).

ArgumentOutOfRangeException

charCount ou byteCount é inferior a zero.

ArgumentException

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

EncoderFallbackException

Ocorreu um recurso de recurso (ver Codificação de Caracteres em .NET para uma explicação mais completa).

- e -

EncoderFallback está definido como EncoderExceptionFallback.

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, podem estar disponíveis apenas 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.

Note

UTF7Encoding não fornece deteção de erros. Caracteres inválidos são codificados como um carácter base 64 modificado. Por razões de segurança, recomenda-se que as suas aplicações utilizem UTF8Encoding, UnicodeEncoding, ou UTF32Encoding e ativem a deteção de erros.

Ver também

Aplica-se a

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

Codifica um conjunto de caracteres do array de caracteres especificado no array de bytes especificado.

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

O array de caracteres que contém o conjunto de caracteres a codificar.

charIndex
Int32

O índice do primeiro carácter a codificar.

charCount
Int32

O número de caracteres a codificar.

bytes
Byte[]

O array de bytes para conter a sequência resultante de bytes.

byteIndex
Int32

O índice onde começar a escrever a sequência resultante de bytes.

Devoluções

Int32

O número real de bytes escritos em bytes.

Exceções

ArgumentNullException

chars é null (Nothing).

-ou-

bytes é null (Nothing).

ArgumentOutOfRangeException

charIndex ou 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

bytes não tem capacidade suficiente de byteIndex até ao fim do array para acomodar os bytes resultantes.

EncoderFallbackException

Ocorreu um recurso de recurso (ver Codificação de Caracteres em .NET para uma explicação mais completa).

- e -

EncoderFallback está definido como EncoderExceptionFallback.

Exemplos

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

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

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, podem estar disponíveis apenas 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.

Note

UTF7Encoding não fornece deteção de erros. Caracteres inválidos são codificados como um carácter base 64 modificado. Por razões de segurança, recomenda-se que as suas aplicações utilizem UTF8Encoding, UnicodeEncoding, ou UTF32Encoding e ativem a deteção de erros.

Ver também

Aplica-se a

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

Codifica um conjunto de caracteres do especificado String para o array de bytes especificado.

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

Parâmetros

s
String

O String que contém o conjunto de caracteres a codificar.

charIndex
Int32

O índice do primeiro carácter a codificar.

charCount
Int32

O número de caracteres a codificar.

bytes
Byte[]

O array de bytes para conter a sequência resultante de bytes.

byteIndex
Int32

O índice onde começar a escrever a sequência resultante de bytes.

Devoluções

Int32

O número real de bytes escritos em bytes.

Atributos
ComVisibleAttribute

Exceções

ArgumentNullException

s é null (Nothing).

-ou-

bytes é null (Nothing).

ArgumentOutOfRangeException

charIndex ou charCount ou byteIndex é menor que zero.

-ou-

charIndex e charCount não denotam um intervalo válido em s.

-ou-

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

ArgumentException

bytes não tem capacidade suficiente de byteIndex até ao fim do array para acomodar os bytes resultantes.

EncoderFallbackException

Ocorreu um recurso de recurso (ver Codificação de Caracteres em .NET para uma explicação mais completa).

- e -

EncoderFallback está definido como EncoderExceptionFallback.

Exemplos

O exemplo de código 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 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

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, podem estar disponíveis apenas 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.

Note

UTF7Encoding não fornece deteção de erros. Caracteres inválidos são codificados como um carácter base 64 modificado. Por razões de segurança, recomenda-se que as suas aplicações utilizem UTF8Encoding, UnicodeEncoding, ou UTF32Encoding e ativem a deteção de erros.

Ver também

Aplica-se a