Application de codage de secours, exemple

Article
09/11/2008

Mise à jour : novembre 2007

Cet exemple illustre les fonctionnalités de la classe Encoding, y compris un mécanisme de secours qui a été incorporé à la version 2.0 du .NET Framework et qui vous permet de spécifier son comportement lorsqu'il rencontre des problèmes pendant le codage ou le décodage.

Pour plus d'informations sur l'utilisation des exemples, consultez les rubriques suivantes :

Download sample

Pour générer l'exemple à partir de l'invite de commande :

Ouvrez la fenêtre d'invite de commande et accédez à l'un des sous-répertoires spécifiques aux différents langages dans le répertoire EncodingApp. Pour plus d'informations sur les paramètres requis et l'invite de commandes du Kit de développement logiciel (SDK), consultez Comment : définir des paramètres d'exemple.
Tapez msbuild EncodingAppCS.sln ou msbuild EncodingAppVB.sln, selon votre choix de langage de programmation.

Pour générer l'exemple à l'aide de Visual Studio :

Ouvrez l'Explorateur Windows et accédez à l'un des sous-répertoires spécifiques aux différents langages dans le répertoire EncodingApp.
Double-cliquez sur le fichier EncodingAppCS.sln ou EncodingAppVB.sln, selon votre choix de langage de programmation, pour ouvrir le fichier dans Visual Studio.
Dans le menu Générer, sélectionnez Générer la solution.

L'application sera générée dans le sous-répertoire \bin ou \bin\Debug par défaut.

Pour exécuter l'exemple

Dans l'Explorateur Windows ou dans la fenêtre d'invite de commande, accédez au répertoire qui contient le nouveau fichier exécutable.
Double-cliquez sur l'icône du fichier EncodingApplication dans l'Explorateur Windows, ou tapez EncodingApplication.exe dans la fenêtre d'invite de commande, pour ouvrir l'application.

Notes

L'exemple génère une application Windows Forms. Vous pouvez la lancer et l'exécuter comme toute application Windows.

Cet exemple met en surbrillance les classes EncoderFallback et DecoderFallback, ainsi que leurs types dérivés, qui exposent les méthodes statiques et les champs permettant aux développeurs de spécifier le comportement de secours de Encoding dans les cas où il ne peut pas coder ou décoder un caractère ou un octet.

Le fichier exécutable EncodingApplication affiche le codage et le décodage de caractères et d'octets dans tout format de codage pris en charge par .NET Framework. Vous pouvez consulter des représentations décimales ou hexadécimales de tout caractère Unicode. Pour plus d'informations sur la norme Unicode, consultez la spécification correspondante sur le site www.unicode.org.

Les types DecoderExceptionFallback et DecoderReplacementFallback sont dérivés de la classe DecoderFallback, et les types EncoderExceptionFallback et EncoderReplacementFallback sont dérivés de la classe EncoderFallback. Chacun de ces types est associé à la classe correspondante dérivée de DecoderFallbackBuffer ou EncoderFallbackBuffer. Le mécanisme de secours de codage dépend des fonctionnalités exposées par ces classes étroitement liées.