Valeurs de retour Main() (Guide de programmation C#)
La méthode Main peut retourner void.
static void Main()
{
//...
}
Elle peut également retourner int :
static int Main()
{
//...
return 0;
}
Si la valeur de retour de Main n'est pas utilisée, retourner void autorise un code légèrement plus simple. Toutefois, retourner un entier permet au programme de communiquer des informations d'état à d'autres programmes ou scripts qui appellent le fichier exécutable. L'exemple suivant affiche la façon d'accéder à la valeur de retour de Main.
Exemple
Dans cet exemple, un fichier de commandes est utilisé pour exécuter un programme et tester la valeur de retour de la fonction Main. Lorsqu'un programme est exécuté dans Windows, toute valeur retournée par la fonction Main est stockée dans une variable d'environnement appelée ERRORLEVEL. Un fichier de commandes peut donc déterminer le résultat de l'exécution en inspectant la variable ERRORLEVEL. Traditionnellement, une valeur de retour de zéro indique que l'exécution a réussi. L'exemple suivant est un programme simple qui retourne la valeur zéro de la fonction Main. Le zéro indique que le programme a fonctionné avec succès. Enregistrez le programme en tant que MainReturnValTest.cs.
// Save this program as MainReturnValTest.cs.
class MainReturnValTest
{
static int Main()
{
//...
return 0;
}
}
Étant donné que cet exemple utilise un fichier de commandes, il vaut mieux compiler le code d'une invite de commandes. Suivez les instructions dans Procédure : définition des variables d'environnement pour la ligne de commande Visual Studio pour activer des générations en ligne de commande ou utilisez l'invite de commandes de Visual Studio, disponible dans le menu Démarrer sous Visual Studio Tools. De l'invite de commandes, naviguez jusqu'au dossier dans lequel vous avez enregistré le programme. La commande suivante compile MainReturnValTest.cs et produit le fichier exécutable MainReturnValTest.exe.
csc MainReturnValTest.cs
Ensuite, créez un fichier de commandes pour exécuter MainReturnValTest.exe et afficher le résultat. Collez le code suivant dans un fichier texte et enregistrez-le en tant que test.bat dans le dossier qui contient MainReturnValTest.cs et MainReturnValTest.exe. Exécutez le fichier de commandes test en tapant ce qui suit à l'invite de commandes.
Étant donné que le code retourne zéro, le fichier de commandes signalera la réussite. Toutefois, si vous modifiez MainReturnValTest.cs pour retourner une valeur différente de zéro et recompiler ensuite le programme, l'exécution suivante du fichier de commandes signalera la défaillance.
rem test.bat
@echo off
MainReturnValTest
@if "%ERRORLEVEL%" == "0" goto good
:fail
echo Execution Failed
echo return value = %ERRORLEVEL%
goto end
:good
echo Execution succeeded
echo Return value = %ERRORLEVEL%
goto end
:end
Résultat de l'exemple
Execution succeeded
Return value = 0
Voir aussi
Tâches
Comment : afficher les arguments de ligne de commande (Guide de programmation C#)
Concepts
Main() et arguments de ligne de commande (Guide de programmation C#)