Vous pouvez utiliser la fonction Nz pour retourner zéro, un chaîne nulle ( » « ), ou une autre valeur spécifiée lorsqu’un variant a la valeur Null. Par exemple, vous pouvez utiliser cette fonction pour convertir une valeur Null en une autre valeur et l’empêcher de se propager via une expression.
Syntaxe
Nz ( variant [, valueifnull ] )
La syntaxe de la fonction Nz comprend les arguments suivants :
|
Argument |
Description |
|
variant |
Obligatoire. Variable de type de donnéesVariant. |
|
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 la valeur de l’argument variant est Null, la fonction Nz retourne le nombre zéro ou une chaîne de longueur nulle (retourne toujours une chaîne de longueur nulle lorsqu’elle est utilisée dans une expression de requête), selon que le contexte indique que la valeur doit être un nombre ou une chaîne. Si l’argument facultatif valueifnull est inclus, la fonction Nz retourne la valeur spécifiée par cet argument si l’argument variant a la valeur Null. Lorsqu’elle est utilisée dans une expression de requête, la fonction NZ doit toujours inclure l’argument valueifnull ,
Si la valeur de variant n’est pas Null, la fonction Nz retourne la valeur de variant.
Remarques
La fonction Nz est utile pour les expressions qui peuvent inclure des valeurs Null . Pour forcer une expression à évaluer à une valeur non Null , même lorsqu’elle contient 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 renvoie toujours une valeur Null lorsque l'varXVariant a la valeur Null. Toutefois, 2 + Nz(varX) retourne 2.
Vous pouvez souvent utiliser la fonction Nz comme alternative à la fonction IIf . Par exemple, dans le code suivant, deux expressions, y compris la fonction IIf , sont nécessaires pour retourner le résultat souhaité. La première expression incluant la fonction IIf est utilisée pour case activée 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 fournit les mêmes fonctionnalités que la première expression, et le résultat souhaité est obtenu en une étape au lieu de deux.
varResult = IIf(Nz(varFreight) > 50, "High", "Low")
Si vous fournissez une valeur pour l’argument facultatif valueifnull, cette valeur est retournée lorsque variant a la valeur Null. En incluant cet argument facultatif, vous pouvez éviter l’utilisation d’une expression contenant la fonction IIf . Par exemple, l’expression suivante utilise la fonction IIf pour renvoyer 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 fourni à la fonction Nz fournit la chaîne à retourner si varFreight a la valeur Null.
varResult = Nz(varFreight, "No Freight Charge")
Exemples de requêtes
|
Expression |
Résultats |
|
SELECT ProductID, NZ(Discount,"No Detail Available ») AS Expr2 FROM ProductSales ; |
Retourne « ProductID » dans la colonne Expr1, évalue les valeurs « Null » dans le champ « Discount » et retourne « Aucun détail disponible » pour toutes les valeurs Null (renvoie les valeurs non null telles quelles). |
|
SELECT ProductID, NZ(Discount,"No Detail Available ») AS ReplaceNull FROM ProductSales ; |
Renvoie « ProductID » dans la colonne Product, évalue les valeurs « Null » dans le champ « Discount » et renvoie « Aucun détail disponible » pour toutes les valeurs Null (retourne les valeurs non Null telles quelles) et s’affiche dans la colonne ReplaceNull. |
Exemple VBA
Remarque : Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour 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 Rechercher et entrez un ou plusieurs termes dans la zone de recherche.
L’exemple suivant évalue un contrôle sur un formulaire et retourne l’une des deux chaînes en fonction de la valeur du contrôle. Si la valeur du contrôle est 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
