UTF8Encoding.GetCharCount Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Calcula o número de caracteres produzidos pela decodificação de uma sequência de bytes.
Sobrecargas
| Name | Description |
|---|---|
| GetCharCount(Byte*, Int32) |
Calcula o número de caracteres produzidos ao descodificar uma sequência de bytes a partir do ponteiro de bytes especificado. |
| GetCharCount(Byte[], Int32, Int32) |
Calcula o número de caracteres produzidos ao descodificar uma sequência de bytes a partir do array de bytes especificado. |
GetCharCount(Byte*, Int32)
Importante
Esta API não está em conformidade com CLS.
Calcula o número de caracteres produzidos ao descodificar uma sequência de bytes a partir do ponteiro de bytes especificado.
public:
override int GetCharCount(System::Byte* bytes, int count);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetCharCount(byte* bytes, int count);[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);[System.CLSCompliant(false)]
public override int GetCharCount(byte* bytes, int count);[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
override this.GetCharCount : nativeptr<byte> * int -> intParâmetros
- bytes
- Byte*
Um apontador para o primeiro byte a descodificar.
- count
- Int32
O número de bytes a descodificar.
Devoluções
O número de caracteres produzidos pela decodificação da sequência especificada de bytes.
- Atributos
Exceções
bytes é null.
count é inferior a zero.
-ou-
O número resultante de bytes é maior do que o número máximo que pode ser devolvido como inteiro.
A deteção de erros está ativada e bytes contém uma sequência inválida de bytes.
Ocorreu um recurso de recurso (para mais informações, veja Codificação de Caracteres em .NET)
- e -
DecoderFallback está definido como DecoderExceptionFallback.
Observações
Para calcular o tamanho exato do array necessário GetChars para armazenar os caracteres resultantes, chama o GetCharCount método. Para calcular o tamanho máximo do array, chama o GetMaxCharCount método. O GetCharCount método geralmente aloca menos memória, enquanto o GetMaxCharCount método geralmente executa mais rapidamente.
Com a deteção de erros, uma sequência inválida faz com que este método crie uma ArgumentException exceção. Sem deteção de erros, as sequências inválidas são ignoradas e nenhuma exceção é lançada.
Ver também
Aplica-se a
GetCharCount(Byte[], Int32, Int32)
Calcula o número de caracteres produzidos ao descodificar uma sequência de bytes a partir do array de bytes especificado.
public:
override int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);public override int GetCharCount(byte[] bytes, int index, int count);override this.GetCharCount : byte[] * int * int -> intPublic Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As IntegerParâmetros
- bytes
- Byte[]
O array de bytes que contém a sequência de bytes a decodificar.
- index
- Int32
O índice do primeiro byte a descodificar.
- count
- Int32
O número de bytes a descodificar.
Devoluções
O número de caracteres produzidos pela decodificação da sequência especificada de bytes.
Exceções
bytes é null.
index ou count é inferior a zero.
-ou-
index e count não denotam um intervalo válido em bytes.
-ou-
O número resultante de bytes é maior do que o número máximo que pode ser devolvido como inteiro.
A deteção de erros está ativada e bytes contém uma sequência inválida de bytes.
Ocorreu um recurso de recurso (para mais informações, veja Codificação de Caracteres em .NET)
- e -
DecoderFallback está definido como DecoderExceptionFallback.
Exemplos
O exemplo seguinte utiliza o GetCharCount método para devolver o número de caracteres produzidos pela decodificação de um intervalo de elementos num array de bytes.
using System;
using System.Text;
class UTF8EncodingExample {
public static void Main() {
Byte[] bytes = new Byte[] {
85, 84, 70, 56, 32, 69, 110,
99, 111, 100, 105, 110, 103, 32,
69, 120, 97, 109, 112, 108, 101
};
UTF8Encoding utf8 = new UTF8Encoding();
int charCount = utf8.GetCharCount(bytes, 2, 8);
Console.WriteLine(
"{0} characters needed to decode bytes.", charCount
);
}
}
Imports System.Text
Class UTF8EncodingExample
Public Shared Sub Main()
Dim bytes() As Byte = { _
85, 84, 70, 56, 32, 69, 110, _
99, 111, 100, 105, 110, 103, 32, _
69, 120, 97, 109, 112, 108, 101 _
}
Dim utf8 As New UTF8Encoding()
Dim charCount As Integer = utf8.GetCharCount(bytes, 2, 8)
Console.WriteLine("{0} characters needed to decode bytes.", charCount)
End Sub
End Class
Observações
Para calcular o tamanho exato do array necessário GetChars para armazenar os caracteres resultantes, chama o GetCharCount método. Para calcular o tamanho máximo do array, chama o GetMaxCharCount método. O GetCharCount método geralmente aloca menos memória, enquanto o GetMaxCharCount método geralmente executa mais rapidamente.
Com a deteção de erros, uma sequência inválida faz com que este método crie uma ArgumentException exceção. Sem deteção de erros, as sequências inválidas são ignoradas e nenhuma exceção é lançada.