ASCIIEncoding.GetByteCount ASCIIEncoding.GetByteCount ASCIIEncoding.GetByteCount ASCIIEncoding.GetByteCount Method

Definición

Calcula el número de bytes generado mediante la codificación de un juego de caracteres.Calculates the number of bytes produced by encoding a set of characters.

Sobrecargas

GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>)

Calcula el número de bytes generado al codificar el intervalo de caracteres especificado.Calculates the number of bytes produced by encoding the specified character span.

GetByteCount(String) GetByteCount(String) GetByteCount(String) GetByteCount(String)

Calcula el número de bytes generado al codificar los caracteres del objeto String especificado.Calculates the number of bytes produced by encoding the characters in the specified String.

GetByteCount(Char*, Int32) GetByteCount(Char*, Int32) GetByteCount(Char*, Int32)

Calcula el número de bytes generado mediante la codificación de un juego de caracteres a partir del puntero de caracteres especificado.Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

GetByteCount(Char[], Int32, Int32) GetByteCount(Char[], Int32, Int32) GetByteCount(Char[], Int32, Int32) GetByteCount(Char[], Int32, Int32)

Calcula el número de bytes generado mediante la codificación de un juego de caracteres de la matriz de caracteres especificada.Calculates the number of bytes produced by encoding a set of characters from the specified character array.

GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>) GetByteCount(ReadOnlySpan<Char>)

Calcula el número de bytes generado al codificar el intervalo de caracteres especificado.Calculates the number of bytes produced by encoding the specified character span.

public:
 override int GetByteCount(ReadOnlySpan<char> chars);
public override int GetByteCount (ReadOnlySpan<char> chars);
override this.GetByteCount : ReadOnlySpan<char> -> int
Public Overrides Function GetByteCount (chars As ReadOnlySpan(Of Char)) As Integer

Parámetros

chars
ReadOnlySpan<Char>

Intervalo que contiene el juego de caracteres que se codificará.The span that contains the set of characters to encode.

Devoluciones

Número de bytes generado al codificar el intervalo de caracteres especificado.The number of bytes produced by encoding the specified character span.

Comentarios

Para calcular el tamaño exacto que necesita GetBytes para almacenar los bytes resultantes, GetByteCountuse.To calculate the exact size required by GetBytes to store the resulting bytes, use GetByteCount. Para calcular el tamaño máximo, use GetMaxByteCount.To calculate the maximum size, use GetMaxByteCount. El GetByteCount método generalmente permite la asignación de menos memoria, mientras GetMaxByteCount que el método suele ejecutarse más rápido.The GetByteCount method generally allows allocation of less memory, while the GetMaxByteCount method generally executes faster.

GetByteCount(String) GetByteCount(String) GetByteCount(String) GetByteCount(String)

Calcula el número de bytes generado al codificar los caracteres del objeto String especificado.Calculates the number of bytes produced by encoding the characters in the specified String.

public:
 override int GetByteCount(System::String ^ chars);
public override int GetByteCount (string chars);
override this.GetByteCount : string -> int
Public Overrides Function GetByteCount (chars As String) As Integer

Parámetros

chars
String String String String

String que contiene el juego de caracteres que se va a codificar.The String containing the set of characters to encode.

Devoluciones

Número de bytes que se generan al codificar los caracteres especificados.The number of bytes produced by encoding the specified characters.

Excepciones

El número de bytes resultante es mayor que el número máximo que se puede devolver como entero.The resulting number of bytes is greater than the maximum number that can be returned as an integer.

Se ha producido una acción de reserva (vea Codificación de caracteres en .NET Framework para obtener una explicación completa).A fallback occurred (see Character Encoding in the .NET Framework for complete explanation) - y --and- El valor de EncoderFallback está establecido en EncoderExceptionFallback.EncoderFallback is set to EncoderExceptionFallback.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar GetByteCount el método para devolver el número de bytes necesarios para codificar una cadena ASCIIEncodingmediante.The following example demonstrates how to use the GetByteCount method to return the number of bytes required to encode a string using ASCIIEncoding.

using namespace System;
using namespace System::Text;
int main()
{
   String^ chars = "ASCII Encoding Example";
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = ascii->GetByteCount( chars );
   Console::WriteLine( " {0} bytes needed to encode string.", byteCount );
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        String chars = "ASCII Encoding Example";

        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = ascii.GetByteCount(chars);
        Console.WriteLine(
            "{0} bytes needed to encode string.", byteCount
        );
    }
}
Imports System
Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim chars As String = "ASCII Encoding Example"

        Dim ascii As New ASCIIEncoding()
        Dim byteCount As Integer = ascii.GetByteCount(chars)
        Console.WriteLine("{0} bytes needed to encode string.", byteCount)
    End Sub
End Class

Comentarios

Para calcular el tamaño exacto de la matriz GetBytes necesario para almacenar los bytes resultantes, la GetByteCountaplicación usa.To calculate the exact array size required by GetBytes to store the resulting bytes, the application uses GetByteCount. Para calcular el tamaño máximo de la matriz, la aplicación GetMaxByteCountdebe usar.To calculate the maximum array size, the application should use GetMaxByteCount. El GetByteCount método generalmente permite la asignación de menos memoria, mientras GetMaxByteCount que el método suele ejecutarse más rápido.The GetByteCount method generally allows allocation of less memory, while the GetMaxByteCount method generally executes faster.

Consulte también:

GetByteCount(Char*, Int32) GetByteCount(Char*, Int32) GetByteCount(Char*, Int32)

Importante

Esta API no es conforme a CLS.

Alternativa conforme a CLS
System.Text.ASCIIEncoding.GetByteCount(Char[], Int32, Int32)

Calcula el número de bytes generado mediante la codificación de un juego de caracteres a partir del puntero de caracteres especificado.Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.

public:
 override int GetByteCount(char* chars, int count);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public override int GetByteCount (char* chars, int count);
override this.GetByteCount : nativeptr<char> * int -> int

Parámetros

chars
Char*

Puntero al primer carácter que se va a codificar.A pointer to the first character to encode.

count
Int32 Int32 Int32 Int32

Número de caracteres que se van a codificar.The number of characters to encode.

Devoluciones

Número de bytes que se generan al codificar los caracteres especificados.The number of bytes produced by encoding the specified characters.

Excepciones

count es menor que cero.count is less than zero.

o bien-or- El número de bytes resultante es mayor que el número máximo que se puede devolver como entero.The resulting number of bytes is greater than the maximum number that can be returned as an integer.

Se ha producido una acción de reserva (vea Codificación de caracteres en .NET Framework para obtener una explicación completa).A fallback occurred (see Character Encoding in the .NET Framework for complete explanation) - y --and- El valor de EncoderFallback está establecido en EncoderExceptionFallback.EncoderFallback is set to EncoderExceptionFallback.

Comentarios

Para calcular el tamaño exacto de la matriz GetBytes necesario para almacenar los bytes resultantes, la GetByteCountaplicación usa.To calculate the exact array size required by GetBytes to store the resulting bytes, the application uses GetByteCount. Para calcular el tamaño máximo de la matriz, la aplicación GetMaxByteCountdebe usar.To calculate the maximum array size, the application should use GetMaxByteCount. El GetByteCount método generalmente permite la asignación de menos memoria, mientras GetMaxByteCount que el método suele ejecutarse más rápido.The GetByteCount method generally allows allocation of less memory, while the GetMaxByteCount method generally executes faster.

Seguridad

SecurityCriticalAttribute
Requiere plena confianza para el llamador inmediato.Requires full trust for the immediate caller. Este miembro no puede ser utilizado por código transparente o de confianza parcial.This member cannot be used by partially trusted or transparent code.

Consulte también:

GetByteCount(Char[], Int32, Int32) GetByteCount(Char[], Int32, Int32) GetByteCount(Char[], Int32, Int32) GetByteCount(Char[], Int32, Int32)

Calcula el número de bytes generado mediante la codificación de un juego de caracteres de la matriz de caracteres especificada.Calculates the number of bytes produced by encoding a set of characters from the specified character array.

public:
 override int GetByteCount(cli::array <char> ^ chars, int index, int count);
public override int GetByteCount (char[] chars, int index, int count);
override this.GetByteCount : char[] * int * int -> int
Public Overrides Function GetByteCount (chars As Char(), index As Integer, count As Integer) As Integer

Parámetros

chars
Char[]

Matriz de caracteres que contiene el juego de caracteres que se va a codificar.The character array containing the set of characters to encode.

index
Int32 Int32 Int32 Int32

Índice del primer carácter que se va a codificar.The index of the first character to encode.

count
Int32 Int32 Int32 Int32

Número de caracteres que se van a codificar.The number of characters to encode.

Devoluciones

Número de bytes que se generan al codificar los caracteres especificados.The number of bytes produced by encoding the specified characters.

Excepciones

index o count es menor que cero.index or count is less than zero.

O bien-or- index y count no denotan un intervalo válido en chars.index and count do not denote a valid range in chars.

O bien-or- El número de bytes resultante es mayor que el número máximo que se puede devolver como entero.The resulting number of bytes is greater than the maximum number that can be returned as an integer.

Se ha producido una acción de reserva (vea Codificación de caracteres en .NET Framework para obtener una explicación completa).A fallback occurred (see Character Encoding in the .NET Framework for complete explanation) - y --and- El valor de EncoderFallback está establecido en EncoderExceptionFallback.EncoderFallback is set to EncoderExceptionFallback.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar GetByteCount el método para devolver el número de bytes necesarios para codificar una matriz de caracteres Unicode ASCIIEncodingmediante.The following example demonstrates how to use the GetByteCount method to return the number of bytes required to encode an array of Unicode characters using ASCIIEncoding.

using namespace System;
using namespace System::Text;
int main()
{
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = ascii->GetByteCount( chars, 1, 2 );
   Console::WriteLine( " {0} bytes needed to encode characters.", byteCount.ToString() );
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };

        ASCIIEncoding ascii = new ASCIIEncoding();
        int byteCount = ascii.GetByteCount(chars, 1, 2);
        Console.WriteLine(
            "{0} bytes needed to encode characters.", byteCount
        );
    }
}
Imports System
Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class ASCIIEncodingExample
    Public Shared Sub Main()
        ' Unicode characters.
        ' ChrW(35)  = #
        ' ChrW(37)  = %
        ' ChrW(928) = Pi
        ' ChrW(931) = Sigma
        Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}

        Dim ascii As New ASCIIEncoding()
        Dim byteCount As Integer = ascii.GetByteCount(chars, 1, 2)
        Console.WriteLine("{0} bytes needed to encode characters.", byteCount)
    End Sub
End Class

Comentarios

Para calcular el tamaño exacto de la matriz GetBytes necesario para almacenar los bytes resultantes, la GetByteCountaplicación usa.To calculate the exact array size required by GetBytes to store the resulting bytes, the application uses GetByteCount. Para calcular el tamaño máximo de la matriz, la aplicación GetMaxByteCountdebe usar.To calculate the maximum array size, the application should use GetMaxByteCount. El GetByteCount método generalmente permite la asignación de menos memoria, mientras GetMaxByteCount que el método suele ejecutarse más rápido.The GetByteCount method generally allows allocation of less memory, while the GetMaxByteCount method generally executes faster.

Consulte también:

Se aplica a