UnicodeEncoding.GetCharCount Método

Referencia

Definición

Espacio de nombres:: System.Text

Ensamblado:: System.Text.Encoding.Extensions.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Calcula el número de caracteres generado mediante la descodificación de una secuencia de bytes.

Sobrecargas

GetCharCount(Byte*, Int32)	Calcula el número de caracteres generado mediante 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 generado mediante la descodificación de una secuencia de bytes a partir de la matriz de bytes especificada.

GetCharCount(Byte*, Int32)

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Importante

Esta API no es conforme a CLS.

Calcula el número de caracteres generado mediante 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)]
[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)>]
override this.GetCharCount : nativeptr<byte> * int -> int

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

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 que se generan al descodificar la secuencia especificada de bytes.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Excepciones

ArgumentNullException

bytes es null (Nothing).

ArgumentOutOfRangeException

count es menor que cero.

O bien

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

ArgumentException

Está habilitada la detección de errores, y bytes contiene una secuencia de bytes no válida.

DecoderFallbackException

Se ha producido una reserva (para más información, vea Codificación de caracteres en .NET)

- y -

El valor de DecoderFallback está establecido en DecoderExceptionFallback.

Comentarios

Para calcular el tamaño exacto de la matriz que GetChars requiere 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. Por lo general, el GetCharCount método asigna menos memoria, mientras que el GetMaxCharCount método generalmente se ejecuta más rápido.

Con la detección de errores, una secuencia no válida hace que este método produzca una ArgumentExceptionexcepción . Sin la detección de errores, se omiten las secuencias no válidas y no se produce ninguna excepción.

Consulte también

Se aplica a

.NET 9 e outras versións

Produto	Versións
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

GetCharCount(Byte[], Int32, Int32)

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Calcula el número de caracteres generado mediante la descodificación de una secuencia de bytes a partir 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 que se generan al descodificar la secuencia especificada de bytes.

Excepciones

ArgumentNullException

bytes es null (Nothing).

ArgumentOutOfRangeException

index o count es menor que cero.

O bien

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

O bien

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

ArgumentException

Está habilitada la detección de errores, y bytes contiene una secuencia de bytes no válida.

DecoderFallbackException

Se ha producido una reserva (para más información, vea Codificación de caracteres en .NET)

- y -

El valor de DecoderFallback está establecido en DecoderExceptionFallback.

Ejemplos

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

using namespace System;
using namespace System::Text;
int main()
{
   array<Byte>^bytes = {85,0,110,0,105,0,99,0,111,0,100,0,101,0};
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int charCount = Unicode->GetCharCount( bytes, 2, 8 );
   Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        UnicodeEncoding Unicode = new UnicodeEncoding();
        int charCount = Unicode.GetCharCount(bytes, 2, 8);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte = {85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0}
        
        Dim uni As New UnicodeEncoding()
        Dim charCount As Integer = uni.GetCharCount(bytes, 2, 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. Por lo general, el GetCharCount método asigna menos memoria, mientras que el GetMaxCharCount método generalmente se ejecuta más rápido.

Consulte también

Se aplica a

.NET 9 e outras versións

Produto	Versións
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Compartir por

UnicodeEncoding.GetCharCount Método

Definición

Sobrecargas

GetCharCount(Byte*, Int32)

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

GetCharCount(Byte[], Int32, Int32)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionais