HOWTO · Csharp
Liste des exceptions en C#
Nous examinerons les exceptions C# qui peuvent être levées dans cet article.
Sur cette page
C# utilise des exceptions pour signaler les échecs survenus pendant l’exécution d’un programme. Les types d’exception spécifiques décrivent la nature du problème, tandis que System.Exception est le type de base commun de la hiérarchie des exceptions .NET. Ce catalogue présente des types utiles issus de plusieurs espaces de noms ; il n’est pas exhaustif, et les types disponibles peuvent varier selon l’implémentation et la version de .NET.
Choisir et gérer les exceptions C#
Choisissez un type qui décrit un échec que votre code peut réellement rencontrer. Pour les valeurs fournies par l’appelant, validez les entrées et signalez les problèmes d’arguments avec ArgumentNullException, ArgumentOutOfRangeException ou ArgumentException. Si une opération ne peut pas être effectuée dans l’état actuel de l’objet, InvalidOperationException convient souvent. Utilisez NotSupportedException lorsque cette implémentation ne prend pas en charge une opération, et non lorsque celle-ci est simplement indisponible dans l’état actuel.
Interceptez une exception à l’endroit où le programme peut récupérer, ajouter un contexte utile ou la traduire à la frontière d’une couche. Interceptez d’abord le type le plus précis. Évitez d’intercepter System.Exception dans le seul but de poursuivre comme si l’opération avait réussi ; consignez ou propagez les échecs que la couche actuelle ne peut pas gérer. Pour relancer la même erreur, utilisez throw; afin de préserver sa trace de pile d’origine. N’utilisez throw new ... que pour traduire l’échec, et conservez l’exception d’origine comme exception interne lorsqu’elle facilite le diagnostic.
Une opération d’analyse peut indiquer si une entrée utilisateur est exploitable sans contrôler le flux du programme au moyen d’une exception. Le code source suivant est autonome ; il n’a pas été exécuté pendant cette étape de rédaction. Pour l’entrée fournie, sa sortie définie est Accepted: 42. Le libellé affiché dans cet exemple inchangé reste en anglais.
L’exemple utilise une chaîne fixe pour vous permettre de vous concentrer sur le déroulement du programme. Dans une application, remplacez-la par une valeur provenant d’un formulaire, de la ligne de commande ou d’un fichier. L’appel à TryParse affecte une valeur à value dans les deux cas. La valeur analysée n’est significative que si la méthode renvoie true ; si elle renvoie false, value reçoit la valeur par défaut de int et la branche d’échec traite l’entrée. Le contrôle des entrées courantes reste ainsi explicite et le programme peut suivre son chemin normal. Vous pouvez remplacer la chaîne par un autre nombre entier et adapter le message affiché aux besoins de votre application.
Exécutez cet exemple :
using System;
class Program
{
static void Main()
{
string input = "42";
if (int.TryParse(input, out int value))
{
Console.WriteLine($"Accepted: {value}");
}
else
{
Console.WriteLine("Enter a whole number.");
}
}
}
TryParse est utile lorsqu’une conversion échouée constitue un résultat attendu que l’appelant peut traiter directement. Si une API signale plutôt l’échec en levant une exception, interceptez les types documentés et attendus, et laissez remonter les échecs sans rapport.
Exceptions système en C#
Ces types sont présents dans les bibliothèques de base .NET. La liste est sélective : certains types sont rares ou liés à des comportements d’exécution spécialisés. Dans la plupart des applications, privilégiez les types plus précis documentés par l’API utilisée.
AccessViolationException- Une tentative d’accès à une mémoire protégée a été détectée ; ce cas est généralement associé au code non sécurisé ou non géré.AppDomainUnloadedException- Le code a tenté d’utiliser un domaine d’application qui a été déchargé.ApplicationException- Ancien type de base pour les échecs propres à une application ; les types personnalisés dérivent généralement deSystem.Exceptionà la place.ArgumentException- Une méthode a reçu un argument qui ne satisfait pas ses exigences.ArgumentNullException- Une méthode a reçunullalors qu’elle ne l’accepte pas.ArgumentOutOfRangeException- La valeur d’un argument se trouve hors de la plage acceptée par la méthode.ArithmeticException- Type de base des échecs liés aux opérations arithmétiques, notammentDivideByZeroExceptionetOverflowException.ArrayTypeMismatchException- L’enregistrement d’une valeur incompatible dans un tableau a échoué, généralement dans le cas d’un tableau covariant.BadImageFormatException- Un fichier n’a pas pu être chargé comme assembly ou module valide, souvent en raison d’un format ou d’une architecture incompatible.CannotUnloadAppDomainException- Une tentative de déchargement d’un domaine d’application a échoué ; ce type concerne principalement les scénarios .NET Framework.ContextMarshalException- Un objet n’a pas pu être marshalé au-delà d’une frontière de contexte de remoting ; il s’agit d’un comportement d’exécution spécialisé.DataMisalignedException- L’accès aux données nécessitait un alignement que la plateforme ou l’opération ne pouvait pas satisfaire.DivideByZeroException- Une division entière ou décimale a utilisé un diviseur égal à zéro.DllNotFoundException- Une bibliothèque native désignée par un import est introuvable.DuplicateWaitObjectException- Une opération d’attente a reçu plusieurs fois le même handle d’attente.EntryPointNotFoundException- Le point d’entrée demandé est introuvable dans une bibliothèque native ou un module cible.ExecutionEngineException- Ancien type d’échec de l’environnement d’exécution ; il est obsolète et ne doit pas servir à signaler des erreurs applicatives ordinaires.FieldAccessException- Le code n’a pas pu accéder à un champ, généralement à cause de restrictions de visibilité ou d’accès.FormatException- Le format d’une valeur ne convient pas à l’opération, par exemple lors de l’analyse d’un texte qui ne correspond pas au format attendu.IndexOutOfRangeException- Un indice de tableau se trouve en dehors de la plage valide. Ce type est scellé.InsufficientMemoryException- Une vérification de la mémoire disponible ou une opération liée à une allocation n’a pas pu fournir la mémoire demandée ; ce type est scellé.InvalidCastException- Une conversion explicite entre des types incompatibles a échoué.InvalidOperationException- Un appel de méthode n’est pas valide dans l’état actuel de l’objet.InvalidProgramException- L’environnement d’exécution n’a pas pu exécuter le programme parce que son langage intermédiaire ou ses métadonnées sont invalides ; cela indique souvent un problème de compilation ou d’outillage.MemberAccessException- Type de base des échecs d’accès à un membre.MethodAccessException- Le code n’a pas pu accéder à une méthode, généralement à cause de restrictions de visibilité ou d’accès.MissingFieldException- Un champ demandé est introuvable lors du chargement ou de l’accès à un type.MissingMemberException- Un membre demandé est introuvable.MissingMethodException- Une méthode demandée est introuvable lors du chargement ou de l’accès à un type.MulticastNotSupportedException- Une opération a tenté de combiner des délégués d’une manière qui n’est pas prise en charge par leur type.NotFiniteNumberException- Ancien type arithmétique destiné aux valeurs non finies, telles queNaNou l’infini ; le code moderne vérifie généralement les valeurs numériques directement.NotImplementedException- Un membre est déclaré, mais son implémentation n’est pas encore disponible. Ne l’utilisez pas pour signaler qu’une opération n’est volontairement pas prise en charge.NotSupportedException- L’objet ou l’implémentation ne prend pas en charge l’opération demandée.NullReferenceException- Le code a tenté d’utiliser un membre sur une référence nulle. Recherchez et corrigez la valeur nulle inattendue au lieu d’utiliser ce type pour valider une entrée.ObjectDisposedException- Le code a tenté d’utiliser un objet après sa libération.OperationCanceledException- Une opération a été annulée ;TaskCanceledExceptionen dérive et apparaît souvent avec les tâches.OutOfMemoryException- L’environnement d’exécution n’a pas pu allouer la mémoire nécessaire. En règle générale, les applications ne peuvent pas récupérer de façon fiable de cette situation.OverflowException- Une opération arithmétique vérifiée ou une conversion a produit une valeur hors de la plage du type cible.PlatformNotSupportedException- Une fonctionnalité n’est pas disponible sur la plateforme actuelle.RankException- Une opération sur un tableau a reçu un tableau dont le nombre de dimensions n’est pas pris en charge.StackOverflowException- La pile d’exécution a été épuisée, souvent à cause d’une récursion sans limite. Il n’est généralement pas possible de récupérer de cette situation.SystemException- Type de base utilisé par de nombreuses exceptions définies par le système ; le code applicatif devrait généralement intercepter un type dérivé plus précis.TimeoutException- Une opération ne s’est pas terminée dans le délai imparti. La possibilité de la réessayer dépend de l’opération.TypeInitializationException- L’initialiseur d’un type a échoué ; consultez sonInnerExceptionpour connaître la cause sous-jacente.TypeLoadException- L’environnement d’exécution n’a pas pu charger un type, par exemple parce qu’il n’a pas pu résoudre sa définition.TypeUnloadedException- Le code a tenté d’utiliser un type associé à un domaine d’application déchargé ; ce cas concerne les environnements d’exécution qui prennent en charge les domaines d’application.UnauthorizedAccessException- Le système d’exploitation ou la ressource a refusé l’accès demandé.
Exceptions System.Data en C#
Ces types sont associés aux tables de données, aux contraintes et aux opérations ADO.NET connexes. Les fournisseurs de bases de données peuvent également exposer leurs propres types d’exception ; pour diagnostiquer un échec de base de données, examinez les détails propres au fournisseur.
ConstraintException- Une opération sur les données a enfreint une contrainte dans unDataSetou une structure de données en mémoire similaire.DataException- Type de base des erreurs levées par les composants liés aux données.DBConcurrencyException- Une opération de mise à jour, d’insertion ou de suppression n’a pas affecté la ligne attendue, souvent parce que les données ont changé depuis leur lecture.DeletedRowInaccessibleException- Le code a tenté d’accéder à une ligne après sa suppression.DuplicateNameException- Une opération a tenté d’ajouter une table ou une colonne dont le nom est déjà utilisé.EvaluateException- Une expression n’a pas pu être évaluée.InRowChangingEventException- Une opération interdite a été tentée pendant un événement de modification d’une ligne.InvalidConstraintException- Une contrainte n’a pas pu être créée ou utilisée comme demandé.InvalidExpressionException- Une expression de données présente une syntaxe invalide ou ne peut pas être évaluée comme spécifié.MissingPrimaryKeyException- Une opération nécessitait la clé primaire d’une table, mais aucune n’était définie.NoNullAllowedException- Une valeur nulle a été affectée à une colonne qui ne les autorise pas.OperationAbortedException- Une opération sur les données a été annulée ou interrompue.ReadOnlyException- Le code a tenté de modifier une colonne ou une valeur en lecture seule.RowNotInTableException- Le code a tenté d’effectuer une opération sur une ligne qui n’appartient pas à la table.StrongTypingException- Une propriété fortement typée deDataSetn’a pas pu convertir sa valeur sous-jacente vers le type demandé.SyntaxErrorException- Une expression de données contient une erreur de syntaxe.TypedDataSetGeneratorException- Le générateur deDataSettypé a rencontré une erreur.VersionNotFoundException- La version de ligne demandée n’est pas disponible.
Exceptions System.IO en C#
Les API de fichiers et de flux signalent couramment ces types d’exception. Ne gérez que les échecs pour lesquels l’application dispose d’un moyen de récupération, comme demander un autre chemin ou réessayer une lecture qui a échoué de façon transitoire.
DirectoryNotFoundException- Un répertoire nécessaire est introuvable.DriveNotFoundException- Un lecteur ou un emplacement réseau nécessaire n’est pas disponible.EndOfStreamException- Une opération de lecture a dépassé la fin d’un flux dont la fin est définie.FileLoadException- Un assembly a été trouvé, mais n’a pas pu être chargé.FileNotFoundException- Un fichier nécessaire est introuvable.IOException- Type de base des échecs d’entrée-sortie, notamment de nombreuses erreurs liées aux fichiers et aux flux.PathTooLongException- Un chemin dépasse une limite imposée par le système d’exploitation ou l’API utilisée ; ces limites dépendent de la plateforme et de la configuration.
Exceptions System.Net en C#
Les échecs réseau peuvent provenir du DNS, de la connexion, du protocole ou du service distant. Le type exact dépend de l’API et de la version de .NET ; examinez les exceptions internes et les détails de la réponse lorsqu’ils sont disponibles.
HttpListenerException- Une opération deHttpListenera échoué et fournit un code d’erreur natif associé.ProtocolViolationException- Une opération réseau a enfreint le protocole attendu par l’API.WebException- Une requête utilisant un protocole Web a échoué, expiré ou reçu une réponse indiquant un échec. Les API HTTP plus récentes peuvent utiliser d’autres types d’exception.
Exceptions System.Net.Mail en C#
Les opérations SMTP peuvent échouer au niveau du transport ou pour certains destinataires. Les données d’exception de l’API peuvent inclure des informations sur l’état du serveur ; évitez de consigner le contenu des messages ou les identifiants de connexion.
SmtpException- Une opération SMTP a échoué pour une raison générale liée au transport ou au serveur.SmtpFailedRecipientException- L’envoi a échoué pour un destinataire ; ce type dérive deSmtpException.SmtpFailedRecipientsException- L’envoi a échoué pour plusieurs destinataires ; examinez les détails propres à chacun.
Exceptions System.Net.NetworkInformation en C#
Les API d’informations réseau peuvent renvoyer ces types. L’impossibilité d’obtenir des informations sur le réseau local ne signifie pas nécessairement qu’un service distant est indisponible.
NetworkInformationException- Une opération d’information réseau a échoué, souvent avec un code d’erreur système sous-jacent.PingException- Une opération ping a échoué parce que l’opération sous-jacente a levé une erreur ; consultez l’exception interne pour en savoir plus.
Exceptions System.Resources en C#
Les échecs liés aux ressources signalent souvent un problème de déploiement ou de configuration de la localisation. Vérifiez les noms de ressources, les actions de génération et le conditionnement des assemblies satellites avant de considérer ces échecs comme temporaires.
MissingManifestResourceException- Le manifeste de ressources principal nécessaire à l’application est introuvable.MissingSatelliteAssemblyException- Un assembly satellite nécessaire à un ensemble de ressources localisé est introuvable.