Le meilleur moyen de vérifier les paramètres nuls (Garde Clauses)

public static class Ensure
{
    ///<summary>
    ///Ensures that the specified argument is not null.
    ///</summary>
    ///<param name="argumentName">Name of the argument.</param>
    ///<param name="argument">The argument.</param>
    [DebuggerStepThrough]
    [ContractAnnotation("halt <= argument:null")]        
    public static void ArgumentNotNull(object argument, [InvokerParameterName] string argumentName)
    {
        if (argument == null)
        {
            throw new ArgumentNullException(argumentName);
        }
    }
}

utilisation:

//C# < 6
public Constructor([NotNull] object foo)
{
    Ensure.ArgumentNotNull(foo, "foo");
    ...
}

//C# >= 6
public Constructor([NotNull] object bar)
{
    Ensure.ArgumentNotNull(bar, nameof(bar));
    ...
}

La DebuggerStepThroughAttribute est assez pratique, de sorte que dans le cas d'une excpetion pendant le débogage (ou quand j'ai attacher le débogueur après que l'exception s'est produite) je ne vais pas finir à l'intérieur de la ArgumentNotNull méthode, mais plutôt à la méthode d'appel où la référence null actually dans les parages.

Je suis en utilisant ReSharper Contrat Annotations.

• La ContractAnnotationAttribute permet de s'assurer que je n'ai jamais mal orthographié
  l'argument ("foo") et aussi le renomme automatiquement si je renomme
  le foo symbole.
• La NotNullAttribute aide ReSharper avec l'analyse de code. Donc, si je ne new Constructor(null) si vous obtenez un avertissement de ReSharper que cela conduira à une exception.
• Si vous n'aimez pas annoter votre code directement,
  vous pouvez également faire la même chose avec externe de fichiers XML que vous pouvez déployer votre bibliothèque et que les utilisateurs peuvent optinally de référence dans leur ReShaprer.

OriginalL'auteur bitbonk

Null références sont un genre de désagréments que vous avez à éviter. Mais, ils ne sont pas le seul. Le problème est plus large que ça, et il se résume à ceci: Méthode accepte les instances d'un certain type, mais il ne peut pas traiter tous les cas.

En d'autres termes, le domaine de la méthode est plus grand que l'ensemble des valeurs qu'il traite. Garde clauses sont ensuite utilisés pour affirmer que le paramètre réel ne tombe pas dans cette "zone grise" de la le domaine de la méthode qui ne peut pas être traitée.

Maintenant, nous avons des références nulles, comme une valeur qui est généralement à l'extérieur de l'ensemble acceptable de valeurs. D'autre part, il arrive souvent que certains non-nulle d'éléments de l'ensemble sont aussi inacceptables (par exemple, une chaîne vide).

Dans ce cas, il peut s'avérer que la signature de la méthode est trop large, ce qui indique alors un problème de conception. Qui peut conduire à une refonte, par exemple, la définition d'un sous-type, généralement un dérivé de l'interface, qui restreint le domaine de la méthode et fait partie de la garde des clauses de disparaître. Vous pouvez trouver un exemple dans cet article: Pourquoi avons-Nous Besoin de la Garde des Clauses?

OriginalL'auteur Zoran Horvat

Vous pouvez essayer le 'Heleonix.La garde de la bibliothèque, qui offre de garde de la fonctionnalité:
https://github.com/Heleonix/Heleonix.Guard/blob/master/README.md
Vous pouvez écrire de la garde des clauses comme ci-dessous:

//C# 7.2+: Non-Trailing named arguments
Throw.ArgumentNullException(when: param.IsNull(), nameof(param));

//OR

//Prior to C# 7.2: You can use a helper method 'When'
Throw.ArgumentNullException(When(param.IsNull()), nameof(param));

//OR
Throw.ArgumentNullException(param == null, nameof(param));

//OR
Throw.ArgumentNullException(When (param == null), nameof(param));

Il fournit à lancer de nombreuses exceptions, et vous pouvez écrire personnalisée des méthodes d'extension pour personnalisé exceptions. Aussi, la bibliothèque se réfère à la " Heleonix.Les Extensions de la bibliothèque avec prédictive des extensions comme IsNull, IsNullOrEmptyOrWhitespace, IsLessThan et beaucoup plus de pour vérifier vos arguments ou variables en fonction de valeurs de votre choix. Contrairement à certains autres de la garde des bibliothèques parle couramment interfaces, ces extensions ne génèrent pas des objets intermédiaires, et depuis la mise en œuvre est vraiment simple, ils sont performants.

OriginalL'auteur Hennadii Lutsyshyn