Fonction Nz
Voir aussiS'applique à
ExempleDétails
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.
Nz(
variant, [
valeur-si-null])
La fonction
Nz possède les arguments suivants :
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.
Remarque 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.
Remarques
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")
Exemple
L'exemple suivant évalue un contrôle de formulaire et retourne une chaîne parmi deux, suivant la valeur du contrôle. Si celle-ci est
Null, la procédure utilise la fonction
Nz pour convertir la valeur
Null en chaîne de longueur nulle.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
| 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 |
Partager