UTF7Encoding.GetByteCount Método

Definição

Espaço de Nomes:: System.Text

Assemblagens:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Text.Encoding.Extensions.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Calcula o número de bytes produzidos ao codificar um conjunto de caracteres.

Sobrecargas

Name	Description
GetByteCount(String)	Calcula o número de bytes produzidos ao codificar os caracteres no objeto especificado String .
GetByteCount(Char*, Int32)	Calcula o número de bytes produzidos ao codificar um conjunto de caracteres a partir do ponteiro especificado.
GetByteCount(Char[], Int32, Int32)	Calcula o número de bytes produzidos ao codificar um conjunto de caracteres a partir do array de caracteres especificado.

GetByteCount(String)

Calcula o número de bytes produzidos ao codificar os caracteres no objeto especificado String .

public:
 override int GetByteCount(System::String ^ s);

public override int GetByteCount(string s);

[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount(string s);

override this.GetByteCount : string -> int

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetByteCount : string -> int

Public Overrides Function GetByteCount (s As String) As Integer

Parâmetros

s: String

O String objeto que contém o conjunto de caracteres a codificar.

Devoluções

Int32

O número de bytes produzidos pela codificação dos caracteres especificados.

Atributos: ComVisibleAttribute

Exceções

ArgumentNullException

s é null (Nothing).

ArgumentOutOfRangeException

O número resultante de bytes é maior do que o número máximo que pode ser devolvido como int.

EncoderFallbackException

Ocorreu um recurso de recurso (para mais informações, ver Codificação de Caracteres em .NET).

- e -

EncoderFallback está definido como EncoderExceptionFallback.

Exemplos

O exemplo de código seguinte demonstra como usar o GetByteCount método para devolver o número de bytes necessários para codificar um array de caracteres.

using System;
using System.Text;

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

        UTF7Encoding utf7 = new UTF7Encoding();
        int byteCount = utf7.GetByteCount(chars, 1, 2);
        Console.WriteLine(
            "{0} bytes needed to encode characters.", byteCount
        );
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF7EncodingExample
    
    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 utf7 As New UTF7Encoding()
        Dim byteCount As Integer = utf7.GetByteCount(chars, 1, 2)
        Console.WriteLine("{0} bytes needed to encode characters.", byteCount)
    End Sub
End Class

Observações

Para calcular o tamanho exato do array que GetBytes requer armazenar os bytes resultantes, a aplicação utiliza GetByteCount. Para calcular o tamanho máximo do array, a aplicação deve usar GetMaxByteCount. O GetByteCount método geralmente permite a alocação de menos memória, enquanto o GetMaxByteCount método geralmente é executado mais rapidamente.

Ver também

Aplica-se a

GetByteCount(Char*, Int32)

Importante

Esta API não está em conformidade com CLS.

Calcula o número de bytes produzidos ao codificar um conjunto de caracteres a partir do ponteiro especificado.

public:
 override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
public override int GetByteCount(char* chars, int count);

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetByteCount : nativeptr<char> * int -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetByteCount : nativeptr<char> * int -> int

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

[<System.CLSCompliant(false)>]
override this.GetByteCount : nativeptr<char> * int -> int

Parâmetros

chars: Char*

Um apontador para o primeiro carácter a codificar.

count: Int32

O número de caracteres a codificar.

Devoluções

Int32

O número de bytes produzidos pela codificação dos caracteres especificados.

Atributos: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Exceções

ArgumentNullException

chars é null (Nothing em Visual Basic .NET).

ArgumentOutOfRangeException

count é inferior a zero.

-ou-

O número resultante de bytes é maior do que o número máximo que pode ser devolvido como int.

EncoderFallbackException

Ocorreu um recurso de recurso (para mais informações, veja Codificação de Caracteres em .NET)

- e -

EncoderFallback está definido como EncoderExceptionFallback.

Observações

Ver também

Aplica-se a

GetByteCount(Char[], Int32, Int32)

Calcula o número de bytes produzidos ao codificar um conjunto de caracteres a partir do array de caracteres especificado.

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

O array de caracteres que contém o conjunto de caracteres a codificar.

index: Int32

O índice do primeiro carácter a codificar.

count: Int32

O número de caracteres a codificar.

Devoluções

Int32

O número de bytes produzidos pela codificação dos caracteres especificados.

Exceções

ArgumentNullException

chars é null (Nothing).

ArgumentOutOfRangeException

index ou count é inferior a zero.

-ou-

index e count não denotam um intervalo válido em chars.

-ou-

O número resultante de bytes é maior do que o número máximo que pode ser devolvido como int.

EncoderFallbackException

Ocorreu um recurso de recurso (para mais informações, veja Codificação de Caracteres em .NET)

- e -

EncoderFallback está definido como EncoderExceptionFallback.

Exemplos

O exemplo de código seguinte demonstra como usar o GetByteCount método para devolver o número de bytes necessários para codificar um array de caracteres Unicode.

using System;
using System.Text;

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

        UTF7Encoding utf7 = new UTF7Encoding();
        int byteCount = utf7.GetByteCount(chars, 1, 2);
        Console.WriteLine(
            "{0} bytes needed to encode characters.", byteCount
        );
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF7EncodingExample
    
    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 utf7 As New UTF7Encoding()
        Dim byteCount As Integer = utf7.GetByteCount(chars, 1, 2)
        Console.WriteLine("{0} bytes needed to encode characters.", byteCount)
    End Sub
End Class

Observações

Para calcular o tamanho exato do array necessário GetBytes para armazenar os bytes resultantes, a aplicação utiliza GetByteCount. Para calcular o tamanho máximo do array, a aplicação deve usar GetMaxByteCount. O GetByteCount método geralmente permite a alocação de menos memória, enquanto o GetMaxByteCount método geralmente é executado mais rapidamente.

Ver também

Aplica-se a

Comentários

Esta página foi útil?