Nz, fonction

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Vous pouvez utiliser la fonction Nz pour renvoyer zéro, un chaîne nulle (« »), ou une autre spécifié valeur lorsque un variante est Null. Par exemple, vous pouvez utiliser cette fonction pour convertir une valeur Null en une autre valeur et éviter de se propager dans une expression.

Syntaxe

Nz ( variant [, valueifnull ] )

La syntaxe de la fonction Nz comprend les arguments suivants :

Argument

Description

variant

Obligatoire. Variable d’une variante type de données.

valueifnull

Facultatif (sauf dans une requête). Variant qui fournit une valeur à renvoyer si l’argument variant est Null. Cet argument vous permet de renvoyer une valeur différente de zéro ou d’une chaîne de longueur nulle.

Remarque : Si vous utilisez la fonction Nz dans une expression dans une requête sans utiliser l’argument valueifnull, le résultat est une chaîne de longueur nulle dans les champs qui contiennent des valeurs Null.


Si l’argument variant a la valeur Null, la fonction Nz renvoie le nombre zéro ou une chaîne de longueur nulle (utilisée dans une expression de requête, elle renvoie toujours une chaîne de longueur nulle ), selon que le contexte indique que la valeur doit être un nombre ou une chaîne. Si l’argument valueifnull facultatif est inclus, la fonction Nz renvoie la valeur spécifiée par celui-ci si l’argument variant a la valeur Null. Dans le cas d’une expression de requête, la fonction Nz doit toujours inclure l’argument valueifnull.

Si l’argument variant n’a pas la valeur Null, la fonction Nzrenvoie la valeur de l’argument variant.

Notes

La fonction Nz est utile pour les expressions pouvant comprendre des valeurs Null. Pour forcer une expression à donner une valeur non Null même quand elle contient une valeur Null, utilisez la fonction Nz pour renvoyer zéro, une chaîne de longueur nulle ou une valeur de retour personnalisée.

Par exemple, l’expression 2 + varX renverra toujours une valeur Null lorsque l’argument variant varX a la valeur Null. Cependant, 2 + Nz(varX) renvoie 2.

La fonction Nz peut souvent être utilisée comme alternative à la fonction IIf. Par exemple, dans le code suivant, deux expressions incluant la fonction IIf sont nécessaires pour renvoyer le résultat souhaité. La première expression comprenant la fonction IIf sert à vérifier la valeur d’une variable et la convertir en zéro si elle a la valeur Null.

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

Dans l’exemple suivant, la fonction Nz offre la même fonctionnalité que la première expression et le résultat escompté est atteint en une seule étape plutôt que deux.

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

Si vous spécifiez une valeur pour l’argument valueifnull facultatif, la valeur sera renvoyée si l’argument variant a la valeur Null. En incluant cet argument facultatif, vous pouvez éviter d’utiliser une expression contenant la fonction IIf. Par exemple, l’expression suivante utilise la fonction IIf pour renvoyer une chaîne si varFreight a la valeur Null.

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

Dans l’exemple suivant, l’argument facultatif spécifié pour la fonction Nz fournit la chaîne à renvoyer si varFreight a la valeur Null.

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

Exemple

Remarque : Exemples suivants illustrent l'utilisation de cette fonction dans une Visual Basic pour le module d'Applications (VBA). Pour plus d'informations sur l'utilisation de VBA, sélectionnez Référence du développeur dans la liste déroulante en regard de recherche et entrez un ou plusieurs termes dans la zone de recherche.

L’exemple suivant évalue un contrôle d’un formulaire et renvoie une des deux chaînes sur la base de la valeur du contrôle. Si le contrôle a la valeur Null, la procédure utilise la fonction Nz pour convertir une valeur Null en chaîne de longueur nulle.

Public Sub CheckValue()
Dim frm As Form
Dim ctl As Control
Dim varResult As Variant
' Return Form object variable
' pointing to Orders form.
Set frm = Forms!Orders
' Return Control object variable
' pointing to ShipRegion.
Set ctl = frm!ShipRegion
' Choose result based on value of control.
varResult = IIf(Nz(ctl.Value) = vbNullString, _
"No value.", "Value is " & ctl.Value & ".")
' Display result.
MsgBox varResult, vbExclamation
End Sub

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×