ASCIIEncoding.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í.
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(ReadOnlySpan<Byte>) |
Calcula el número de caracteres generado al descodificar el intervalo de bytes especificado. |
GetCharCount(Byte*, Int32)
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.cs
- 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 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)]
[System.Security.SecurityCritical]
public override int GetCharCount (byte* bytes, int count);
[System.CLSCompliant(false)]
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)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
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
Número de caracteres que se generan al descodificar la secuencia especificada de bytes.
- Atributos
Excepciones
bytes
es null
.
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.
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 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 GetCharCount método generalmente permite la asignación de menos memoria, mientras que el GetMaxCharCount método suele ejecutarse más rápido.
Consulte también
Se aplica a
GetCharCount(Byte[], Int32, Int32)
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.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
Número de caracteres que se generan al descodificar la secuencia especificada de bytes.
Excepciones
bytes
es null
.
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.
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.
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 GetCharCount método generalmente permite la asignación de menos memoria, mientras que el GetMaxCharCount método suele ejecutarse más rápido.
Consulte también
Se aplica a
GetCharCount(ReadOnlySpan<Byte>)
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.cs
- Source:
- ASCIIEncoding.cs
Calcula el número de caracteres generado 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 descodificará.
Devoluciones
Número de caracteres generado 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 GetCharCount método generalmente permite la asignación de menos memoria, mientras que el GetMaxCharCount método suele ejecutarse más rápido.