Decoder.GetCharCount Método
Definición
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í.
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)
- Source:
- Decoder.cs
- Source:
- Decoder.cs
- Source:
- Decoder.cs
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 -> intPublic Overridable Function GetCharCount (bytes As ReadOnlySpan(Of Byte), flush As Boolean) As IntegerPará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
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 que GetChars requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount.
Si GetChars se llama a con flush establecido falseen , el descodificador almacena bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación de descodificación. La aplicación debe llamar a GetCharCount en un bloque de datos inmediatamente antes de llamar GetChars a en el mismo bloque, de modo que los bytes finales del bloque anterior se incluyan en el cálculo.
Se aplica a
GetCharCount(Byte*, Int32, Boolean)
- Source:
- Decoder.cs
- Source:
- Decoder.cs
- Source:
- Decoder.cs
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);[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[<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 -> intPará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
Número de caracteres que se generan al descodificar la secuencia especificada de bytes y los bytes del búfer interno.
- Atributos
Excepciones
bytes es null (Nothing en Visual Basic .NET).
count es menor que cero.
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 que GetChars requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount.
Si GetChars se llama a con flush establecido falseen , el descodificador almacena bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación de descodificación. La aplicación debe llamar a GetCharCount en un bloque de datos inmediatamente antes de llamar GetChars a en el mismo bloque, de modo que los bytes finales del bloque anterior se incluyan en el cálculo.
Consulte también
Se aplica a
GetCharCount(Byte[], Int32, Int32)
- Source:
- Decoder.cs
- Source:
- Decoder.cs
- Source:
- Decoder.cs
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 -> intPublic MustOverride Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As IntegerPará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
Número de caracteres que se generan al descodificar la secuencia especificada de bytes y los bytes del búfer interno.
Excepciones
bytes es null (Nothing).
index o count es menor que cero.
O bien
index y count no denotan un intervalo válido en bytes.
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 GetCharCount método para calcular el número de caracteres necesarios para descodificar el intervalo de 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 que GetChars requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount.
Si GetChars se llama a con flush establecido falseen , el descodificador almacena bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación de descodificación. La aplicación debe llamar a GetCharCount en un bloque de datos inmediatamente antes de llamar GetChars a en el mismo bloque, de modo que los bytes finales del bloque anterior se incluyan en el cálculo.
Consulte también
Se aplica a
GetCharCount(Byte[], Int32, Int32, Boolean)
- Source:
- Decoder.cs
- Source:
- Decoder.cs
- Source:
- Decoder.cs
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 -> intPublic Overridable Function GetCharCount (bytes As Byte(), index As Integer, count As Integer, flush As Boolean) As IntegerPará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
Número de caracteres que se generan al descodificar la secuencia especificada de bytes y los bytes del búfer interno.
- Atributos
Excepciones
bytes es null (Nothing).
index o count es menor que cero.
O bien
index y count no denotan un intervalo válido en bytes.
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 que GetChars requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount.
Si GetChars se llama a con flush establecido falseen , el descodificador almacena bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación de descodificación. La aplicación debe llamar a GetCharCount en un bloque de datos inmediatamente antes de llamar GetChars a en el mismo bloque, de modo que los bytes finales del bloque anterior se incluyan en el cálculo.
