UTF7Encoding.GetChars Metodo

Definizione

Spazio dei nomi:
System.Text
Assembly:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
System.Text.Encoding.Extensions.dll
Assembly:
netstandard.dll

Decodifica una sequenza di byte in un set di caratteri.

Overload

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

Decodifica una sequenza di byte a partire dal puntatore di byte specificato in un set di caratteri archiviati a partire dal puntatore di caratteri specificato.
GetChars(Byte[], Int32, Int32, Char[], Int32)

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

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

Importante

Questa API non è conforme a CLS.

Decodifica una sequenza di byte a partire dal puntatore di byte specificato in un set di caratteri archiviati a partire dal puntatore di 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)]
[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)]
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)>]
[<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
[<System.CLSCompliant(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.

Valori restituiti

Int32

Numero effettivo di caratteri scritti nella posizione indicata da chars.

Attributi
CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Eccezioni

ArgumentNullException

bytes è null (Nothing).

oppure

chars è null (Nothing).

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 la dimensione esatta della matrice richiesta da GetChars per archiviare i caratteri risultanti, usare GetCharCount. Per calcolare le dimensioni massime della matrice, l'applicazione deve usare GetMaxCharCount. Il GetCharCount metodo in genere consente l'allocazione di meno memoria, mentre il GetMaxCharCount metodo viene generalmente eseguito più velocemente.

I dati da convertire, ad esempio i dati letti da un flusso, potrebbero 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 rispettivamente l'oggetto o Encoder fornito dal GetDecoder metodo o dal GetEncoder metodo .

Note

UTF7Encoding non fornisce il rilevamento degli errori. Quando vengono rilevati byte non validi, UTF7Encoding genera in genere i byte non validi. Se un byte è maggiore del 0x7F esadecimale, il valore di byte viene esteso zero in un carattere Unicode, il risultato viene archiviato nella chars matrice e qualsiasi sequenza di spostamento viene terminata. Ad esempio, se il byte da codificare è 0x81 esadecimale, il carattere risultante è U+0081. Per motivi di sicurezza, le applicazioni sono consigliate per 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 in cui contenere il set di caratteri risultante.

charIndex
Int32

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

Valori restituiti

Int32

Numero effettivo di caratteri scritti in chars.

Eccezioni

ArgumentNullException

bytes è null (Nothing).

oppure

chars è null (Nothing).

ArgumentOutOfRangeException

byteIndex o è byteCountcharIndex minore di zero.

oppure

byteIndex e byteCount non indicano un intervallo valido in bytes.

oppure

charIndex non è un indice valido in chars.

ArgumentException

chars non dispone di capacità sufficiente dalla charIndex 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 di codice seguente viene illustrato come usare il GetChars metodo per decodificare un intervallo di elementi in una matrice di byte e archiviare il risultato in una matrice di caratteri.

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             85,  84,  70,  55,  32,  69, 110,
             99, 111, 100, 105, 110, 103,  32,
             69, 120,  97, 109, 112, 108, 101
        };

        UTF7Encoding utf7 = new UTF7Encoding();

        int charCount = utf7.GetCharCount(bytes, 2, 8);
        chars = new Char[charCount];
        int charsDecodedCount = utf7.GetChars(bytes, 2, 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 UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85,  84,  70,  55,  32,  69, 110, _
            99, 111, 100, 105, 110, 103,  32, _
            69, 120,  97, 109, 112, 108, 101 _
        }
        
        Dim utf7 As New UTF7Encoding()
        
        Dim charCount As Integer = utf7.GetCharCount(bytes, 2, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = utf7.GetChars(bytes, 2, 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

Per calcolare la dimensione esatta della matrice richiesta da GetChars per archiviare i caratteri risultanti, usare GetCharCount. Per calcolare le dimensioni massime della matrice, l'applicazione deve usare GetMaxCharCount. Il GetCharCount metodo in genere consente l'allocazione di meno memoria, mentre il GetMaxCharCount metodo viene generalmente eseguito più velocemente.

I dati da convertire, ad esempio i dati letti da un flusso, potrebbero 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 rispettivamente l'oggetto o Encoder fornito dal GetDecoder metodo o dal GetEncoder metodo .

Note

UTF7Encoding non fornisce il rilevamento degli errori. Quando vengono rilevati byte non validi, UTF7Encoding genera in genere i byte non validi. Se un byte è maggiore del 0x7F esadecimale, il valore di byte viene esteso zero in un carattere Unicode, il risultato viene archiviato nella chars matrice e qualsiasi sequenza di spostamento viene terminata. Ad esempio, se il byte da codificare è 0x81 esadecimale, il carattere risultante è U+0081. Per motivi di sicurezza, le applicazioni sono consigliate per usare UTF8Encoding, UnicodeEncodingo UTF32Encoding e abilitare il rilevamento degli errori.

Vedi anche

Si applica a