ASCIIEncoding.GetChars Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Text

Assembly:: System.Text.Encoding.Extensions.dll

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

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Decodifica una sequenza di byte in un set di caratteri.

Overload

GetChars(ReadOnlySpan<Byte>, Span<Char>)	Decodifica l'intervallo di byte specificato nell'intervallo di caratteri specificato.
GetChars(Byte, Int32, Char, Int32)	Decodifica una sequenza di byte a partire dal puntatore ai byte specificato in un set di caratteri archiviati a partire dal puntatore ai caratteri specificato.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Decodifica una sequenza di byte dalla matrice di byte specificata nella matrice di caratteri specificata.

GetChars(ReadOnlySpan<Byte>, Span<Char>)

Decodifica l'intervallo di byte specificato nell'intervallo di caratteri specificato.

public:
 override int GetChars(ReadOnlySpan<System::Byte> bytes, Span<char> chars);

public override int GetChars (ReadOnlySpan<byte> bytes, Span<char> chars);

override this.GetChars : ReadOnlySpan<byte> * Span<char> -> int

Public Overrides Function GetChars (bytes As ReadOnlySpan(Of Byte), chars As Span(Of Char)) As Integer

Parametri

bytes: ReadOnlySpan<Byte>

Intervallo contenente i byte da decodificare.

chars: Span<Char>

Intervallo che conterrà il set di caratteri risultante.

Restituisce

Int32

Numero effettivo di caratteri scritti in chars.

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.

I dati da convertire, ad esempio i dati letti da un flusso, possono essere disponibili solo in blocchi sequenziali. In questo caso, o se la quantità di dati è così grande che deve essere suddivisa in blocchi più piccoli, è consigliabile usare rispettivamente il Decoder o Encoder il metodo fornito dal metodo o dal GetDecoder GetEncoder metodo.

ASCIIEncoding non fornisce il rilevamento degli errori. Qualsiasi byte maggiore dell'esadecimale 0x7F viene decodificato come punto interrogativo Unicode ("?").

Attenzione

Per motivi di sicurezza, è consigliabile usare UTF8Encoding, UnicodeEncodingo UTF32Encoding e abilitare il rilevamento degli errori.

Si applica a

GetChars(Byte, Int32, Char, Int32)

Importante

Questa API non è conforme a CLS.

Alternativa conforme a CLS: System.Text.ASCIIEncoding.GetChars(Byte[], Int32, Int32, Char[], Int32)

Decodifica una sequenza di byte a partire dal puntatore ai byte specificato in un set di caratteri archiviati a partire dal puntatore ai caratteri specificato.

public:
 override int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);

[System.CLSCompliant(false)]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetChars (byte* bytes, int byteCount, char* chars, int charCount);

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

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

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

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

Parametri

bytes: Byte*

Puntatore al primo byte da decodificare.

byteCount: Int32

Numero di byte da decodificare.

chars: Char*

Puntatore alla posizione in cui iniziare a scrivere il set di caratteri risultante.

charCount: Int32

Numero massimo di caratteri da scrivere.

Restituisce

Int32

Numero effettivo di caratteri scritti nella posizione indicata da chars.

Attributi: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Eccezioni

ArgumentNullException

bytes è null.

-oppure- chars è null.

ArgumentOutOfRangeException

byteCount o charCount è minore di zero.

ArgumentException

charCount è minore del numero di caratteri risultante.

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.

I dati da convertire, ad esempio i dati letti da un flusso, possono essere disponibili solo in blocchi sequenziali. In questo caso, o se la quantità di dati è così grande che deve essere suddivisa in blocchi più piccoli, l'applicazione deve usare Decoder Encoder rispettivamente o il GetDecoder metodo fornito dal metodo o dal GetEncoder metodo.

ASCIIEncoding non fornisce il rilevamento degli errori. Qualsiasi byte maggiore del 0x7F esadecimale viene decodificato come punto interrogativo Unicode ("?").

Attenzione

Per motivi di sicurezza, è consigliabile usare UTF8Encoding, UnicodeEncodingo UTF32Encoding e abilitare il rilevamento degli errori.

Vedi anche

Si applica a

GetChars(Byte[], Int32, Int32, Char[], Int32)

Decodifica una sequenza di byte dalla matrice di byte specificata nella matrice di caratteri specificata.

public:
 override int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);

public override int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

override this.GetChars : byte[] * int * int * char[] * int -> int

Public Overrides Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

Parametri

bytes: Byte[]

Matrice di byte contenente la sequenza di byte da decodificare.

byteIndex: Int32

Indice del primo byte da decodificare.

byteCount: Int32

Numero di byte da decodificare.

chars: Char[]

Matrice di caratteri che deve contenere il set di caratteri risultante.

charIndex: Int32

Indice in corrispondenza del quale iniziare a scrivere il set di caratteri risultante.

Restituisce

Int32

Numero effettivo di caratteri scritti in chars.

Eccezioni

ArgumentNullException

bytes è null.

-oppure- chars è null.

ArgumentOutOfRangeException

byteIndex o byteCount o charIndex è minore di zero.

-oppure- byteindex e byteCount non identificano un intervallo valido in bytes.

-oppure- charIndex non è un indice valido in chars.

ArgumentException

chars non dispone di sufficiente capacità da charIndex alla fine della matrice per contenere i caratteri risultanti.

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 decodificare un intervallo di elementi da una matrice di byte e archiviare il risultato in un set di elementi in una matrice di caratteri Unicode.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   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 );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = ascii->GetChars( bytes, 6, 8, chars, 0 );
   Console::WriteLine( "{0} characters used to decode bytes.", charsDecodedCount );
   Console::Write( "Decoded chars: " );
   IEnumerator^ myEnum = chars->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c = safe_cast<Char>(myEnum->Current);
      Console::Write( "[{0}]", c.ToString() );
   }

   Console::WriteLine();
}

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Char[] chars;
        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);
        chars = new Char[charCount];
        int charsDecodedCount = ascii.GetChars(bytes, 6, 8, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class ASCIIEncodingExample
    Public Shared Sub Main()
        Dim chars() As Char
        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)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = ascii.GetChars(bytes, 6, 8, chars, 0)

        Console.WriteLine("{0} characters used to decode bytes.", charsDecodedCount)

        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

Commenti

I dati da convertire, ad esempio i dati letti da un flusso, possono essere disponibili solo in blocchi sequenziali. In questo caso, o se la quantità di dati è così grande che deve essere suddivisa in blocchi più piccoli, l'applicazione deve usare Decoder Encoder rispettivamente o il GetDecoder metodo fornito dal metodo o dal GetEncoder metodo.

ASCIIEncoding non fornisce il rilevamento degli errori. Qualsiasi byte maggiore del 0x7F esadecimale viene decodificato come punto interrogativo Unicode ("?").

Attenzione

Per motivi di sicurezza, è consigliabile usare UTF8Encoding, UnicodeEncodingo UTF32Encoding e abilitare il rilevamento degli errori.

Vedi anche

Si applica a

ASCIIEncoding.GetChars Metodo

Definizione

Overload

GetChars(ReadOnlySpan<Byte>, Span<Char>)

Parametri

Restituisce

Commenti

Si applica a

GetChars(Byte*, Int32, Char*, Int32)

Parametri

Restituisce

Eccezioni

Commenti

Vedi anche

Si applica a

GetChars(Byte[], Int32, Int32, Char[], Int32)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive

GetChars(Byte, Int32, Char, Int32)