Decoder.GetCharCount Método

Definición

Espacio de nombres:

System.Text

Ensamblado:

System.Runtime.dll

Ensamblado:

netstandard.dll

Ensamblado:

mscorlib.dll

Ensamblado:

System.Text.Encoding.dll

Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes.

Sobrecargas

GetCharCount(ReadOnlySpan<Byte>, Boolean)	Cuando se invalida en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes en el intervalo. Un parámetro indica si se debe borrar el estado interno del descodificador después del cálculo.
GetCharCount(Byte*, Int32, Boolean)	Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes a partir del puntero de bytes especificado. Un parámetro indica si se debe borrar el estado interno del descodificador después del cálculo.
GetCharCount(Byte[], Int32, Int32)	Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes de la matriz de bytes especificada.
GetCharCount(Byte[], Int32, Int32, Boolean)	Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes de la matriz de bytes especificada. Un parámetro indica si se debe borrar el estado interno del descodificador después del cálculo.

GetCharCount(ReadOnlySpan<Byte>, Boolean)

Cuando se invalida en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes en el intervalo. Un parámetro indica si se debe borrar el estado interno del descodificador después del cálculo.

public:
 virtual int GetCharCount(ReadOnlySpan<System::Byte> bytes, bool flush);

public virtual int GetCharCount (ReadOnlySpan<byte> bytes, bool flush);

abstract member GetCharCount : ReadOnlySpan<byte> * bool -> int
override this.GetCharCount : ReadOnlySpan<byte> * bool -> int

Public Overridable Function GetCharCount (bytes As ReadOnlySpan(Of Byte), flush As Boolean) As Integer

Parámetros

bytes

ReadOnlySpan<Byte>

Un intervalo de bytes que se va a descodificar.

flush

Boolean

true para simular el borrado del estado interno del codificador después del cálculo; de lo contrario, false.

Devoluciones

Int32

Número de caracteres que se generan al descodificar la secuencia especificada de bytes y los bytes del búfer interno.

Comentarios

Este método no afecta al estado del descodificador.

Para calcular el tamaño exacto del búfer GetChars que requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount .

Si se llama a con establecido en , el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación GetChars flush de false descodificación. La aplicación debe llamar a en un bloque de datos inmediatamente antes de llamar a en el mismo bloque, de modo que los bytes finales del bloque anterior se GetCharCount GetChars incluyan en el cálculo.

GetCharCount(Byte*, Int32, Boolean)

Importante

Esta API no es conforme a CLS.

Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes a partir del puntero de bytes especificado. Un parámetro indica si se debe borrar el estado interno del descodificador después del cálculo.

public:
 virtual int GetCharCount(System::Byte* bytes, int count, bool flush);

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

public virtual int GetCharCount (byte* bytes, int count, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetCharCount (byte* bytes, int count, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual int GetCharCount (byte* bytes, int count, bool flush);

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

abstract member GetCharCount : nativeptr<byte> * int * bool -> int
override this.GetCharCount : nativeptr<byte> * int * bool -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetCharCount : nativeptr<byte> * int * bool -> int
override this.GetCharCount : nativeptr<byte> * int * bool -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member GetCharCount : nativeptr<byte> * int * bool -> int
override this.GetCharCount : nativeptr<byte> * int * bool -> 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.

flush

Boolean

true para simular el borrado del estado interno del codificador después del cálculo; de lo contrario, false.

Devoluciones

Int32

Número de caracteres que se generan al descodificar la secuencia especificada de bytes y los bytes del búfer interno.

Atributos

CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Excepciones

ArgumentNullException

bytes es null (Nothing en Visual Basic .NET).

ArgumentOutOfRangeException

count es menor que cero.

DecoderFallbackException

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

• y -

El valor de Fallback está establecido en DecoderExceptionFallback.

Comentarios

Este método no afecta al estado del descodificador.

Para calcular el tamaño exacto de la matriz GetChars que requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount .

Si se llama a con establecido en , el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación GetChars flush de false descodificación. La aplicación debe llamar a en un bloque de datos inmediatamente antes de llamar a en el mismo bloque, de modo que los bytes finales del bloque anterior se GetCharCount GetChars incluyan en el cálculo.

Consulte también

• GetChars(Byte*, Int32, Char*, Int32, Boolean)
• Reset()

GetCharCount(Byte[], Int32, Int32)

Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes de la matriz de bytes especificada.

public:
 abstract int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);

public abstract int GetCharCount (byte[] bytes, int index, int count);

abstract member GetCharCount : byte[] * int * int -> int

Public MustOverride 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 y los bytes del búfer interno.

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.

DecoderFallbackException

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

• y -

El valor de Fallback está establecido en DecoderExceptionFallback.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el método para calcular el número de caracteres necesarios para descodificar el intervalo de GetCharCount bytes especificado en la matriz.

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};
   Decoder^ uniDecoder = Encoding::Unicode->GetDecoder();
   int charCount = uniDecoder->GetCharCount( bytes, 0, bytes->Length );
   Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}

/* This code example produces the following output.

7 characters needed to decode bytes.

*/

using System;
using System.Text;

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

        Decoder uniDecoder = Encoding.Unicode.GetDecoder();
        int charCount = uniDecoder.GetCharCount(bytes, 0, bytes.Length);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}

/* This code example produces the following output.

7 characters needed to decode bytes.

*/

Imports System.Text

Class DecoderExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte = { _
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0 _
        }
        
        Dim uniDecoder As Decoder = Encoding.Unicode.GetDecoder()
        Dim charCount As Integer = uniDecoder.GetCharCount(bytes, 0, bytes.Length)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    End Sub
End Class

'This code example produces the following output.
'
'7 characters needed to decode bytes.
'

Comentarios

Este método no afecta al estado del descodificador.

Para calcular el tamaño exacto de la matriz GetChars que requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount .

Si se llama a con establecido en , el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación GetChars flush de false descodificación. La aplicación debe llamar a en un bloque de datos inmediatamente antes de llamar a en el mismo bloque, de modo que los bytes finales del bloque anterior se GetCharCount GetChars incluyan en el cálculo.

Consulte también

• GetChars(Byte[], Int32, Int32, Char[], Int32)
• Reset()

GetCharCount(Byte[], Int32, Int32, Boolean)

Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes de la matriz de bytes especificada. Un parámetro indica si se debe borrar el estado interno del descodificador después del cálculo.

public:
 virtual int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count, bool flush);

public virtual int GetCharCount (byte[] bytes, int index, int count, bool flush);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetCharCount (byte[] bytes, int index, int count, bool flush);

abstract member GetCharCount : byte[] * int * int * bool -> int
override this.GetCharCount : byte[] * int * int * bool -> int

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetCharCount : byte[] * int * int * bool -> int
override this.GetCharCount : byte[] * int * int * bool -> int

Public Overridable Function GetCharCount (bytes As Byte(), index As Integer, count As Integer, flush As Boolean) 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.

flush

Boolean

true para simular el borrado del estado interno del codificador después del cálculo; de lo contrario, false.

Devoluciones

Int32

Número de caracteres que se generan al descodificar la secuencia especificada de bytes y los bytes del búfer interno.

Atributos

ComVisibleAttribute

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.

DecoderFallbackException

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

• y -

El valor de Fallback está establecido en DecoderExceptionFallback.

Comentarios

Este método no afecta al estado del descodificador.

Para calcular el tamaño exacto de la matriz GetChars que requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount .

Si se llama a con establecido en , el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación GetChars flush de false descodificación. La aplicación debe llamar a en un bloque de datos inmediatamente antes de llamar a en el mismo bloque, de modo que los bytes finales del bloque anterior se GetCharCount GetChars incluyan en el cálculo.

Consulte también

• GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)
• Reset()