ASCIIEncoding.GetCharCount Metodo

Definizione

Spazio dei nomi:

System.Text

Assembly:

System.Text.Encoding.Extensions.dll

Calcola il numero di caratteri prodotti dalla decodifica di una sequenza di byte.

Overload

GetCharCount(Byte*, Int32)	Calcola il numero di caratteri prodotti dalla decodifica di una sequenza di byte a partire dal puntatore ai byte specificato.
GetCharCount(Byte[], Int32, Int32)	Calcola il numero di caratteri prodotti dalla decodifica di una sequenza di byte dalla matrice di byte specificata.
GetCharCount(ReadOnlySpan<Byte>)	Calcola il numero di caratteri prodotti dalla decodifica dell'intervallo di byte specificato.

GetCharCount(Byte*, Int32)

Origine:

ASCIIEncoding.cs

Importante

Questa API non è conforme a CLS.

Alternativa conforme a CLS

System.Text.ASCIIEncoding.GetCharCount(Byte[], Int32, Int32)

Calcola il numero di caratteri prodotti dalla decodifica di una sequenza di byte a partire dal puntatore ai byte specificato.

public:
 override int GetCharCount(System::Byte* bytes, int count);

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

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

Parametri

bytes

Byte*

Puntatore al primo byte da decodificare.

count

Int32

Numero di byte da decodificare.

Restituisce

Int32

Numero di caratteri prodotti dalla decodifica della sequenza di byte specificata.

Attributi

CLSCompliantAttribute

Eccezioni

ArgumentNullException

bytes è null.

ArgumentOutOfRangeException

count è minore di zero.

-oppure-

Il numero di byte ottenuto è maggiore del numero massimo che può essere restituito come valore integer.

DecoderFallbackException

Si è verificato un fallback (per altre informazioni, vedere Codifica dei caratteri in .NET)

-e-

DecoderFallback è impostato su DecoderExceptionFallback.

Commenti

Per calcolare le dimensioni esatte della matrice richieste da GetChars per archiviare i caratteri risultanti, l'applicazione usa GetCharCount. Per calcolare le dimensioni massime della matrice, l'applicazione deve usare GetMaxCharCount. Il GetCharCount metodo in genere consente l'allocazione di una quantità di memoria inferiore, mentre il GetMaxCharCount metodo viene in genere eseguito più velocemente.

Vedi anche

• GetChars
• GetMaxCharCount(Int32)
• GetDecoder()

GetCharCount(Byte[], Int32, Int32)

Origine:

ASCIIEncoding.cs

Calcola il numero di caratteri prodotti dalla decodifica di una sequenza di byte dalla matrice di byte specificata.

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

Parametri

bytes

Byte[]

Matrice di byte contenente la sequenza di byte da decodificare.

index

Int32

Indice del primo byte da decodificare.

count

Int32

Numero di byte da decodificare.

Restituisce

Int32

Numero di caratteri prodotti dalla decodifica della sequenza di byte specificata.

Eccezioni

ArgumentNullException

bytes è null.

ArgumentOutOfRangeException

index o count è minore di zero.

-oppure-

index e count non identificano un intervallo valido in bytes.

-oppure-

Il numero di byte ottenuto è maggiore del numero massimo che può essere restituito come valore integer.

DecoderFallbackException

Si è verificato un fallback (per altre informazioni, vedere Codifica dei caratteri in .NET)

-e-

DecoderFallback è impostato su DecoderExceptionFallback.

Esempio

Nell'esempio seguente viene illustrato come usare il metodo per restituire il GetCharCount numero di caratteri generati decodificando un intervallo di elementi in una matrice di byte.

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

Commenti

Per calcolare le dimensioni esatte della matrice richieste da GetChars per archiviare i caratteri risultanti, l'applicazione usa GetCharCount. Per calcolare le dimensioni massime della matrice, l'applicazione deve usare GetMaxCharCount. Il GetCharCount metodo in genere consente l'allocazione di una quantità di memoria inferiore, mentre il GetMaxCharCount metodo viene in genere eseguito più velocemente.

Vedi anche

• GetChars
• GetMaxCharCount(Int32)
• GetDecoder()

GetCharCount(ReadOnlySpan<Byte>)

Origine:

ASCIIEncoding.cs

Calcola il numero di caratteri prodotti dalla decodifica dell'intervallo di byte specificato.

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

Parametri

bytes

ReadOnlySpan<Byte>

Intervallo contenente il set di byte da decodificare.

Restituisce

Int32

Numero di caratteri prodotti dalla decodifica dell'intervallo di byte specificato.

Commenti

Per calcolare le dimensioni esatte necessarie per GetChars archiviare i caratteri risultanti, usare GetCharCount. Per calcolare le dimensioni massime, usare GetMaxCharCount. Il GetCharCount metodo in genere consente l'allocazione di una quantità di memoria inferiore, mentre il GetMaxCharCount metodo viene in genere eseguito più velocemente.