ASCIIEncoding.GetCharCount Método

Definición

Espacio de nombres:

System.Text

Ensamblado:

System.Text.Encoding.Extensions.dll

Calcula el número de caracteres generados por la descodificación de una secuencia de bytes.

Sobrecargas

GetCharCount(Byte*, Int32)	Calcula el número de caracteres generados por la descodificación de una secuencia de bytes a partir del puntero de bytes especificado.
GetCharCount(Byte[], Int32, Int32)	Calcula el número de caracteres generados al descodificar una secuencia de bytes de la matriz de bytes especificada.
GetCharCount(ReadOnlySpan<Byte>)	Calcula el número de caracteres producidos al descodificar el intervalo de bytes especificado.

GetCharCount(Byte*, Int32)

Source:

ASCIIEncoding.cs

Importante

Esta API no es conforme a CLS.

Alternativa conforme a CLS

System.Text.ASCIIEncoding.GetCharCount(Byte[], Int32, Int32)

Calcula el número de caracteres generados por la descodificación de una secuencia de bytes a partir del puntero de bytes especificado.

public:
 override int GetCharCount(System::Byte* bytes, int count);

[System.CLSCompliant(false)]
public override int GetCharCount (byte* bytes, int count);

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

Parámetros

bytes

Byte*

Puntero al primer byte que se va a descodificar.

count

Int32

Número de bytes que se van a descodificar.

Devoluciones

Int32

Número de caracteres producidos al descodificar la secuencia de bytes especificada.

Atributos

CLSCompliantAttribute

Excepciones

ArgumentNullException

bytes es null.

ArgumentOutOfRangeException

count es menor que cero.

-o-

El número resultante de bytes es mayor que el número máximo que se puede devolver como un entero.

DecoderFallbackException

Se produjo una reserva (para obtener más información, vea codificación de caracteres en .NET)

-y-

DecoderFallback se establece en DecoderExceptionFallback.

Comentarios

Para calcular el tamaño exacto de la matriz requerido por GetChars para almacenar los caracteres resultantes, la aplicación usa GetCharCount. Para calcular el tamaño máximo de la matriz, la aplicación debe usar GetMaxCharCount. El método GetCharCount generalmente permite la asignación de menos memoria, mientras que el método GetMaxCharCount generalmente se ejecuta más rápido.

Consulte también

• GetChars
• GetMaxCharCount(Int32)
• GetDecoder()

GetCharCount(Byte[], Int32, Int32)

Source:

ASCIIEncoding.cs

Calcula el número de caracteres generados al descodificar una secuencia de bytes de la matriz de bytes especificada.

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 -> int

Public Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integer

Parámetros

bytes

Byte[]

Matriz de bytes que contiene la secuencia de bytes que se va a descodificar.

index

Int32

Índice del primer byte que se va a descodificar.

count

Int32

Número de bytes que se van a descodificar.

Devoluciones

Int32

Número de caracteres producidos al descodificar la secuencia de bytes especificada.

Excepciones

ArgumentNullException

bytes es null.

ArgumentOutOfRangeException

index o count es menor que cero.

-o-

index y count no denotan un intervalo válido en bytes.

-o-

El número resultante de bytes es mayor que el número máximo que se puede devolver como un entero.

DecoderFallbackException

Se produjo una reserva (para obtener más información, vea codificación de caracteres en .NET)

-y-

DecoderFallback se establece en DecoderExceptionFallback.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el método GetCharCount para devolver el número de caracteres generados mediante la descodificación de un intervalo de elementos en una matriz de bytes.

using namespace System;
using namespace System::Text;
int main()
{
   array<Byte>^bytes = {65,83,67,73,73,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int charCount = ascii->GetCharCount( bytes, 6, 8 );
   Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Byte[] bytes = new Byte[] {
             65,  83,  67,  73,  73,  32,  69,
            110,  99, 111, 100, 105, 110, 103,
             32,  69, 120,  97, 109, 112, 108, 101
        };

        ASCIIEncoding ascii = new ASCIIEncoding();
        int charCount = ascii.GetCharCount(bytes, 6, 8);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim bytes() As Byte = { _
             65,  83,  67,  73,  73,  32,  69, _
            110,  99, 111, 100, 105, 110, 103, _
             32,  69, 120,  97, 109, 112, 108, 101}
      
        Dim ascii As New ASCIIEncoding()
        Dim charCount As Integer = ascii.GetCharCount(bytes, 6, 8)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    End Sub
End Class

Comentarios

Para calcular el tamaño exacto de la matriz requerido por GetChars para almacenar los caracteres resultantes, la aplicación usa GetCharCount. Para calcular el tamaño máximo de la matriz, la aplicación debe usar GetMaxCharCount. El método GetCharCount generalmente permite la asignación de menos memoria, mientras que el método GetMaxCharCount generalmente se ejecuta más rápido.

Consulte también

• GetChars
• GetMaxCharCount(Int32)
• GetDecoder()

GetCharCount(ReadOnlySpan<Byte>)

Source:

ASCIIEncoding.cs

Calcula el número de caracteres producidos al descodificar el intervalo de bytes especificado.

public:
 override int GetCharCount(ReadOnlySpan<System::Byte> bytes);

public override int GetCharCount (ReadOnlySpan<byte> bytes);

override this.GetCharCount : ReadOnlySpan<byte> -> int

Public Overrides Function GetCharCount (bytes As ReadOnlySpan(Of Byte)) As Integer

Parámetros

bytes

ReadOnlySpan<Byte>

Intervalo que contiene el conjunto de bytes que se va a descodificar.

Devoluciones

Int32

Número de caracteres generados al descodificar el intervalo de bytes especificado.

Comentarios

Para calcular el tamaño exacto requerido por GetChars para almacenar los caracteres resultantes, use GetCharCount. Para calcular el tamaño máximo, use GetMaxCharCount. El método GetCharCount generalmente permite la asignación de menos memoria, mientras que el método GetMaxCharCount generalmente se ejecuta más rápido.