Sécurité Mécapoulets

Archives Google         Base de connaissance       Forum Access        Sommaire   
Présentation Access 2007          Articles indispensables de la base de connaissance   
Téléchargement    Librairies    Abonnement   
Nz  VBA OfficeSystem.Access 2000 - 2007    
Blog 2000-2003
Blog 2007
Annuaire
Accueil
Remonter

Le Runtime Access 2007 français est disponible




Vous pouvez utiliser la fonction Nz pour retourner zéro, une chaîne de longueur nulle ("") ou une autre valeur spécifiée lorsqu'une donnée de type Variant est Null. Par exemple, vous pouvez utiliser cette fonction pour convertir une valeur Null en une autre valeur et l'empêcher de se répéter dans une expression.

Syntaxe : 

            Nz(variant, [valeur-si-null])

La fonction Nz possède les arguments suivants :

Arguments de la fonction Nz
Argument Description
variant Variable de type de données Variant.
valeur-si-null Facultatif (sauf si la fonction est utilisée dans une requête). Donnée de type Variant qui fournit une valeur à retourner si l'argument variant est Null. Cet argument vous permet de retourner une valeur différente de zéro ou une chaîne nulle.
Si vous utilisez la fonction Nz dans une expression au sein d'une requête sans spécifier l'argument valeur-si-null, les champs contenant des valeurs Null seront vides.
 

Si la valeur de l'argument variant est Null, la fonction Nz retourne le nombre zéro ou une chaîne de longueur nulle (toujours une chaîne de longueur nulle dans une expression de requête), suivant que le contexte indique ou non que cette valeur doit être un nombre ou une chaîne. Si l'argument facultatif valeur-si-null est défini, la fonction Nz retournera la valeur spécifiée par cet argument dans le cas où l'argument variant est Null. Lorsque la fonction NZ est utilisée dans une expression de requête, elle doit toujours inclure l'argument valeur-si-null.

Si la valeur de variant n'est pas Null, la fonction Nz retourne la valeur de variant.

La fonction Nz est utile dans le cadre des expressions qui peuvent comprendre des valeurs Null. Pour qu'une expression soit évaluée comme une valeur non Null même si elle inclut une valeur Null, utilisez la fonction Nz pour retourner zéro, une chaîne de longueur nulle ou une valeur de retour personnalisée.

Par exemple, l'expression 2 + varX retournera toujours une valeur Null si la variable Variant varX est Null. Cependant, 2 + Nz(varX) retourne 2.

La fonction Nz peut souvent remplacer une fonction IIf. Par exemple, dans le code suivant, il faut deux expressions incluant la fonction IIf pour retourner le résultat souhaité. La première expression qui contient la fonction IIf sert à contrôler la valeur d'une variable et à la convertir en zéro si elle est Null.

varTemp = IIf(IsNull(varFreight), 0, varFreight)
varResult = IIf(varTemp > 50, "High", "Low")
		

Dans l'exemple suivant, la fonction Nz procure la même fonctionnalité que la première expression et le résultat souhaité est atteint en une instruction au lieu de deux.

varResult = IIf(Nz(varFreight) > 50, "High", "Low")
		

Si vous attribuez une valeur à l'argument facultatif valeur-si-null, cette valeur est retournée lorsque variant est Null. En incluant cet argument facultatif, vous éviterez peut-être l'utilisation d'une expression comprenant la fonction IIf. Par exemple, l'expression suivante utilise la fonction IIf pour retourner une chaîne si la valeur de varFreight est Null.

varResult = IIf(IsNull(varFreight), "No Freight Charge", varFreight)
		

Dans l'exemple suivant, l'argument facultatif spécifié dans le cadre de la fonction Nz fournit la chaîne à retourner si varFreight est Null.

varResult = Nz(varFreight, "No Freight Charge")