Introduction - Les Commentaires - Gestion des exceptions

	Cours du langage C Sharp pour les débutants
	Commentaires Développer et déployer facilement vos sites web Télécharger gratuitement Office 2013 Héberger votre site web sur des serveurs gratuits Visual Studio 2013 Télécharger et apprenez gratuitement Trucs et Astuces Découvrez Windows 8.1 et télécharger le gratuitement   Il est important de fournir une documentation adéquate pour toutes vos applications. Vous devez fournir des commentaires suffisants pour qu'un développeur n'ayant pas participé à la création de l'application d'origine soit en mesure de suivre et de comprendre son fonctionnement. Utilisez des commentaires précis et explicites. Les bons commentaires ajoutent des informations que l'instruction de code seule ne suffit pas à expliciter ; ils expliquent le « pourquoi » plutôt que le « qu'est-ce que c'est ». Si votre entreprise applique des règles en matière de commentaires, vous devez les respecter. C# permet d'ajouter des commentaires au code des applications de plusieurs manières : commentaires sur une seule ligne, commentaires sur plusieurs lignes ou documentation générée au format XML. Vous pouvez ajouter un commentaire sur une seule ligne en utilisant les barres obliques (//). Lors de l'exécution de votre application, tout ce qui suit ces deux caractères jusqu'à la fin de la ligne est ignoré. // lit le nom de l’utilisateur Console.WriteLine("Comment vous appelez-vous?"); name = Console.ReadLine(); Vous pouvez également utiliser des commentaires de bloc qui couvrent plusieurs lignes. Ce type de commentaires commence par la paire de caractères /* et continue jusqu'à la paire de caractères */ correspondante. Vous ne pouvez pas imbriquer de commentaires de bloc. /* La classe Print pour créer des rapport en pdf */ x = (...); Création d’une documentation XML Vous pouvez utiliser des commentaires C# pour générer une documentation XML pour vos applications. Les commentaires des documentations commencent par trois barres obliques (///) suivies d'une balise de documentation XML. Pour consulter des exemples, reportez-vous à la diapositive. Vous pouvez utiliser les balises XML qui vous sont proposées, ou créer les vôtres. Le tableau suivant contient certaines balises XML et leur utilisation. Vous pouvez compiler les balises XML et la documentation dans un fichier XML en utilisant le compilateur C# avec l'option /doc : csc myprogram.cs /doc:mycomments.xml S'il n'y a pas d'erreur, vous pouvez visualiser le fichier XML généré à l'aide d'un outil tel qu'Internet Explorer. Le rôle de l'option /doc consiste uniquement à générer un fichier XML. Pour afficher le fichier, vous avez besoin d'autre processeur. L'affichage du fichier sous Internet Explorer est simple, se limitant à rendre sa structure ; il permet le développement ou la réduction des balises, mais il n'affiche pas la balise <list type="bullet"> en tant que puce. Exemple : /// <summary> La classe Hello affiche un message /// de bienvenue à l'écran /// </summary> public class Hello { /// <remarks> On utilisons l'E/S de la console. /// Pour plus d'informations sur WriteLine, consultez /// <seealso cref="System.Console.WriteLine"/> /// </remarks> public static void Main() { Console.WriteLine("Hello, World!"); } }   -  Déposez votre CV -  lien de téléchargement direct -  50 tirages offerts à l'inscription chez myPIX.com! -  Dépot de CV gratuit sur Touslesemplois -  Logiciel de référencement automatique