Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto manualmente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale.
Traduzione
Originale

Classe UTF7Encoding

Rappresenta una codifica UTF-7 dei caratteri Unicode.

Spazio dei nomi:  System.Text
Assembly:  mscorlib (in mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class UTF7Encoding : Encoding

Il tipo UTF7Encoding espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoSupportato da XNA FrameworkUTF7Encoding()Inizializza una nuova istanza della classe UTF7Encoding.
Metodo pubblicoSupportato da XNA FrameworkUTF7Encoding(Boolean)Inizializza una nuova istanza della classe UTF7Encoding. Un parametro specifica se consentire caratteri facoltativi.
In alto

  NomeDescrizione
Proprietà pubblicaBodyNameQuando sottoposto a override in una classe derivata, ottiene un nome per la codifica corrente che può essere utilizzato con i tag body degli agenti di posta. (Ereditato da Encoding)
Proprietà pubblicaSupportato da XNA FrameworkCodePageQuando sottoposto a override in una classe derivata, ottiene l'identificatore della tabella codici dell'oggetto Encoding corrente. (Ereditato da Encoding)
Proprietà pubblicaDecoderFallbackOttiene o imposta l'oggetto DecoderFallback per l'oggetto Encoding corrente. (Ereditato da Encoding)
Proprietà pubblicaEncoderFallbackOttiene o imposta l'oggetto EncoderFallback per l'oggetto Encoding corrente. (Ereditato da Encoding)
Proprietà pubblicaEncodingNameQuando sottoposto a override in una classe derivata, ottiene la descrizione leggibile della codifica corrente. (Ereditato da Encoding)
Proprietà pubblicaHeaderNameQuando sottoposto a override in una classe derivata, ottiene un nome per la codifica corrente che può essere utilizzato con i tag di intestazione degli agenti di posta. (Ereditato da Encoding)
Proprietà pubblicaIsBrowserDisplayQuando sottoposto a override in una classe derivata, ottiene un valore che indica se la codifica corrente può essere utilizzata dai browser client per visualizzare il contenuto. (Ereditato da Encoding)
Proprietà pubblicaIsBrowserSaveQuando sottoposto a override in una classe derivata, ottiene un valore che indica se la codifica corrente può essere utilizzata dai browser client per salvare il contenuto. (Ereditato da Encoding)
Proprietà pubblicaIsMailNewsDisplayQuando sottoposto a override in una classe derivata, ottiene un valore che indica se la codifica corrente può essere utilizzata dai client di posta e dai client delle news per visualizzare il contenuto. (Ereditato da Encoding)
Proprietà pubblicaIsMailNewsSaveQuando sottoposto a override in una classe derivata, ottiene un valore che indica se la codifica corrente può essere utilizzata dai client di posta e dai client delle news per salvare il contenuto. (Ereditato da Encoding)
Proprietà pubblicaIsReadOnlyQuando sottoposto a override in una classe derivata, consente di ottenere un valore che indica se la codifica corrente è in sola lettura. (Ereditato da Encoding)
Proprietà pubblicaIsSingleByteQuando sottoposto a override in una classe derivata, ottiene un valore che indica se la codifica corrente utilizza punti di codice a un byte. (Ereditato da Encoding)
Proprietà pubblicaSupportato da XNA FrameworkWebNameQuando sottoposto a override in una classe derivata, ottiene il nome registrato con IANA (Internet Assigned Numbers Authority) per la codifica corrente. (Ereditato da Encoding)
Proprietà pubblicaWindowsCodePageQuando sottoposto a override in una classe derivata, ottiene la tabella codici del sistema operativo Windows che meglio corrisponde alla codifica corrente. (Ereditato da Encoding)
In alto

  NomeDescrizione
Metodo pubblicoSupportato da XNA FrameworkCloneQuando sottoposto a override in una classe derivata, consente di creare un duplicato superficiale dell'oggetto Encoding corrente. (Ereditato da Encoding)
Metodo pubblicoSupportato da XNA FrameworkEqualsOttiene un valore che indica se l'oggetto specificato è uguale all'oggetto UTF7Encoding corrente. (Esegue l'override di Encoding.Equals(Object)).
Metodo protettoSupportato da XNA FrameworkFinalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblicoSupportato da XNA FrameworkGetByteCount(Char[])Quando sottoposto a override in una classe derivata, calcola il numero di byte prodotti dalla codifica di tutti i caratteri della matrice di caratteri specificata. (Ereditato da Encoding)
Metodo pubblicoSupportato da XNA FrameworkGetByteCount(String)Calcola il numero di byte prodotti dalla codifica dei caratteri nell'oggetto String specificato. (Esegue l'override di Encoding.GetByteCount(String)).

In XNA Framework 3.0 questo membro viene ereditato da Encoding.GetByteCount(String).
Metodo pubblicoGetByteCount(Char*, Int32)Calcola il numero di byte prodotti dalla codifica di un insieme di caratteri a partire dal puntatore ai caratteri specificato. (Esegue l'override di Encoding.GetByteCount(Char*, Int32)).
Metodo pubblicoSupportato da XNA FrameworkGetByteCount(Char[], Int32, Int32)Consente di calcolare il numero di byte prodotti dalla codifica di un insieme di caratteri nella matrice di caratteri specificata. (Esegue l'override di Encoding.GetByteCount(Char[], Int32, Int32)).
Metodo pubblicoSupportato da XNA FrameworkGetBytes(Char[])Quando sottoposto a override in una classe derivata, codifica tutti i caratteri della matrice di caratteri specificata in una sequenza di byte. (Ereditato da Encoding)
Metodo pubblicoSupportato da XNA FrameworkGetBytes(String)Quando sottoposto a override in una classe derivata, codifica tutti i caratteri della stringa specificata in una sequenza di byte. (Ereditato da Encoding)
Metodo pubblicoSupportato da XNA FrameworkGetBytes(Char[], Int32, Int32)Quando sottoposto a override in una classe derivata, codifica un insieme di caratteri partendo dalla matrice di caratteri specificata in una sequenza di byte. (Ereditato da Encoding)
Metodo pubblicoGetBytes(Char*, Int32, Byte*, Int32)Consente di codificare un insieme di caratteri, a partire dal puntatore ai caratteri specificato, in una sequenza di byte archiviati a partire dal puntatore ai byte specificato. (Esegue l'override di Encoding.GetBytes(Char*, Int32, Byte*, Int32)).
Metodo pubblicoSupportato da XNA FrameworkGetBytes(Char[], Int32, Int32, Byte[], Int32)Codifica un set di caratteri dalla matrice di caratteri specificata nella matrice di byte specificata. (Esegue l'override di Encoding.GetBytes(Char[], Int32, Int32, Byte[], Int32)).
Metodo pubblicoSupportato da XNA FrameworkGetBytes(String, Int32, Int32, Byte[], Int32)Consente di codificare un insieme di caratteri dall'oggetto String specificato nella matrice di byte specificata. (Esegue l'override di Encoding.GetBytes(String, Int32, Int32, Byte[], Int32)).

In XNA Framework 3.0 questo membro viene ereditato da Encoding.GetBytes(String, Int32, Int32, Byte[], Int32).
Metodo pubblicoSupportato da XNA FrameworkGetCharCount(Byte[])Quando sottoposto a override in una classe derivata, calcola il numero di caratteri prodotti dalla decodifica di tutti i byte nella matrice di byte specificata. (Ereditato da Encoding)
Metodo pubblicoGetCharCount(Byte*, Int32)Calcola il numero di caratteri prodotti dalla decodifica di una sequenza di byte a partire dal puntatore ai byte specificato. (Esegue l'override di Encoding.GetCharCount(Byte*, Int32)).
Metodo pubblicoSupportato da XNA FrameworkGetCharCount(Byte[], Int32, Int32)Consente di calcolare il numero di caratteri prodotti dalla decodifica di una sequenza di byte dalla matrice di byte specificata. (Esegue l'override di Encoding.GetCharCount(Byte[], Int32, Int32)).
Metodo pubblicoSupportato da XNA FrameworkGetChars(Byte[])Quando sottoposto a override in una classe derivata, decodifica tutti i byte nella matrice di byte specificata in un insieme di caratteri. (Ereditato da Encoding)
Metodo pubblicoSupportato da XNA FrameworkGetChars(Byte[], Int32, Int32)Quando sottoposto a override in una classe derivata, decodifica una sequenza di byte partendo dalla matrice di byte specificata in un insieme di caratteri. (Ereditato da Encoding)
Metodo pubblicoGetChars(Byte*, Int32, Char*, Int32)Consente di decodificare una sequenza di byte a partire dal puntatore ai byte specificato in un insieme di caratteri archiviati a partire dal puntatore ai caratteri specificato. (Esegue l'override di Encoding.GetChars(Byte*, Int32, Char*, Int32)).
Metodo pubblicoSupportato da XNA FrameworkGetChars(Byte[], Int32, Int32, Char[], Int32)Decodifica una sequenza di byte dalla matrice di byte specificata nella matrice di caratteri specificata. (Esegue l'override di Encoding.GetChars(Byte[], Int32, Int32, Char[], Int32)).
Metodo pubblicoSupportato da XNA FrameworkGetDecoderOttiene un decodificatore in grado di convertire una sequenza di byte codificati UTF-7 in una sequenza di caratteri Unicode. (Esegue l'override di Encoding.GetDecoder()).
Metodo pubblicoSupportato da XNA FrameworkGetEncoderOttiene un codificatore in grado di convertire una sequenza di caratteri Unicode in una sequenza di byte codificati UTF-7. (Esegue l'override di Encoding.GetEncoder()).
Metodo pubblicoSupportato da XNA FrameworkGetHashCodeRestituisce il codice hash per l'oggetto UTF7Encoding corrente. (Esegue l'override di Encoding.GetHashCode()).
Metodo pubblicoSupportato da XNA FrameworkGetMaxByteCountConsente di calcolare il numero massimo di byte prodotti dalla codifica del numero di caratteri specificato. (Esegue l'override di Encoding.GetMaxByteCount(Int32)).
Metodo pubblicoSupportato da XNA FrameworkGetMaxCharCountConsente di calcolare il numero massimo di caratteri prodotti dalla decodifica del numero di byte specificato. (Esegue l'override di Encoding.GetMaxCharCount(Int32)).
Metodo pubblicoSupportato da XNA FrameworkGetPreambleQuando sottoposto a override in una classe derivata, restituisce una sequenza di byte che specifica la codifica utilizzata. (Ereditato da Encoding)
Metodo pubblicoGetString(Byte[])Quando sottoposto a override in una classe derivata, decodifica tutti i byte della matrice di byte specificata in una stringa. (Ereditato da Encoding)
Metodo pubblicoSupportato da XNA FrameworkGetString(Byte[], Int32, Int32)Decodifica un intervallo di byte da una matrice di byte in una stringa. (Esegue l'override di Encoding.GetString(Byte[], Int32, Int32)).

In XNA Framework 3.0 questo membro viene ereditato da Encoding.GetString(Byte[], Int32, Int32).
Metodo pubblicoSupportato da XNA FrameworkGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblicoIsAlwaysNormalized()Ottiene un valore che indica se la codifica corrente è sempre normalizzata, utilizzando la forma di normalizzazione predefinita. (Ereditato da Encoding)
Metodo pubblicoIsAlwaysNormalized(NormalizationForm)Quando sottoposto a override in una classe derivata, ottiene un valore che indica se la codifica corrente viene sempre normalizzata, utilizzando la forma di normalizzazione specificata. (Ereditato da Encoding)
Metodo protettoSupportato da XNA FrameworkMemberwiseClone Crea una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblicoSupportato da XNA FrameworkToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
In alto

La codifica è il processo di trasformazione di un insieme di caratteri Unicode in una sequenza di byte. La decodifica è il processo di trasformazione di una sequenza di byte codificati in un insieme di caratteri Unicode.

La codifica UTF-7 rappresenta i caratteri Unicode come sequenze di caratteri ASCII a 7 bit. Questa codifica supporta determinati protocolli per i quali è richiesta, si tratta per lo più protocolli di posta elettronica o di newsgroup. Poiché UTF-7 non è particolarmente sicuro o affidabile e la maggior parte dei sistemi moderni consente codifiche a 8 bit, UTF-8 deve essere generalmente preferito a UTF-7.

NotaNota

UTF7Encoding non fornisce il rilevamento errori. Per motivi di sicurezza, si consiglia che l'applicazione utilizzi UTF8Encoding, UnicodeEncoding o UTF32Encoding e di attivare il rilevamento errori.

Per maggiori informazioni sui formati UTF e altre codifiche supportate da System.Text, vedere Codifica di caratteri in .NET Framework e Uso della codifica Unicode.

Il metodo GetByteCount consente di determinare il numero di byte risultanti dalla codifica di un set di caratteri Unicode, mentre il metodo GetBytes consente di eseguire la codifica.

Analogamente, il metodo GetCharCount consente di determinare il numero di caratteri risultanti dalla decodifica di una sequenza di byte, mentre i metodi GetChars e GetString eseguono la decodifica effettiva.

UTF7Encoding corrisponde alla tabella codici di Windows 65000.

NotaNota

Lo stato di un oggetto codificato UTF-7 non viene mantenuto se le relative operazioni di serializzazione e deserializzazione vengono eseguite con versioni di .NET Framework diverse.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare UTF7Encoding per codificare una stringa di caratteri Unicode e memorizzarli in una matrice di byte. Si noti che quando la matrice di byte viene decodificata in una stringa, non si verifica perdita di dati.


using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        // Create a UTF-7 encoding.
        UTF7Encoding utf7 = new UTF7Encoding();

        // A Unicode string with two characters outside a 7-bit code range.
        String unicodeString =
            "This Unicode string contains two characters " +
            "with codes outside a 7-bit code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = utf7.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();

        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = utf7.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}


.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft