Nz-Funktion

Sie können die NZ -Funktion verwenden, um NULL, eine Leere Zeichenfolge ("") oder einen anderen angegebenen Wert zurück zugeben, wenn ein Variant-Wert NULL ist. Mit dieser Funktion können Sie beispielsweise einen null -Wert in einen anderen Wert umwandeln und verhindern, dass er über einen Ausdruck weitergegeben wird.

Syntax

NZ ( Variant [, WertWennNull ] )

Die Syntax der Nz-Funktion weist die folgenden Argumente auf:

Argument

Beschreibung

Variante

Erforderlich. Eine Variable vom DatentypVariante.

WertWennNull

Optional (außer bei Verwendung in einer Abfrage). Ein Wert vom Typ Variante, der einen Wert liefert, der zurückgegeben wird, wenn das Argument Variante gleich Null ist. Mit diesem Argument können Sie einen anderen Wert als Null oder eine Zeichenfolge der Länge Null zurückgeben.

Hinweis: Wenn Sie die Nz-Funktion in einem Ausdruck in einer Abfrage ohne das Argument WertWennNull verwenden, wird in den Feldern, die Nullwerte enthalten, als Ergebnis eine Zeichenfolge der Länge Null zurückgegeben.


Wenn der Wert des Variant -Arguments nullist, gibt die NZ -Funktion die Zahl 0 (null) oder eine leere Zeichenfolge (immer eine leere Zeichenfolge zurück, wenn Sie in einem Abfrageausdruck verwendet wird) zurück, je nachdem, ob der Kontext den Wert angibt. sollte eine Zahl oder eine Zeichenfolge sein. Wenn das optionale Argument WertWennNull enthalten ist, gibt die NZ -Funktion den Wert zurück, der durch dieses Argument angegeben wird, wenn das Argument Variantnullist. Bei Verwendung in einem Abfrageausdruck sollte die NZ -Funktion immer das WertWennNull -Argument umfassen.

Wenn der Wert von Variant nicht nullist, gibt die NZ -Funktion den Wert von Variantzurück.

Hinweise

Die NZ -Funktion eignet sich für Ausdrücke, die null -Werte enthalten können. Um zu erzwingen, dass ein Ausdruck auch dann zu einem ungleichnull -Wert ausgewertet wird, wenn er einen null -Wert enthält, verwenden Sie die NZ -Funktion, um 0 (null), eine Zeichenfolge der Länge 0 oder einen benutzerdefinierten Rückgabewert zurückzugeben.

Der Ausdruck 2 + varX gibt beispielsweise immer einen Nullwert zurück, wenn die Variant -varXnullist. 2 + Nz(varX) gibt jedoch 2 zurück.

Sie können die NZ -Funktion häufig als Alternative zur IIf -Funktion verwenden. Im folgenden Codebeispiel sind zwei Ausdrücke, einschließlich der Funktion IIf , erforderlich, um das gewünschte Ergebnis zurückzugeben. Der erste Ausdruck, einschließlich der Funktion IIf , wird verwendet, um den Wert einer Variablen zu überprüfen und in NULL umzuwandeln, wenn Sie nullist.

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

Im nächsten Beispiel bietet die NZ -Funktion die gleiche Funktionalität wie der erste Ausdruck, und das gewünschte Ergebnis wird in einem Schritt und nicht in zwei Schritten erzielt.

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

Wenn Sie einen Wert für das optionale Argument WertWennNullangeben, wird dieser Wert zurückgegeben, wenn Variant gleich nullist. Durch einschließen dieses optionalen Arguments können Sie möglicherweise die Verwendung eines Ausdrucks vermeiden, der die IIf -Funktion enthält. Im folgenden Ausdruck wird beispielsweise die IIf -Funktion verwendet, um eine Zeichenfolge zurückzugeben, wenn der Wert von varFreightnullist.

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

Im nächsten Beispiel stellt das optionale Argument, das für die NZ -Funktion bereitgestellt wird, die Zeichenfolge bereit, die zurückgegeben werden soll, wenn varFreightnullist.

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

Abfragebeispiele

Ausdruck

Ergebnisse

Wählen Sie ProductID, NZ (Discount, "keine Details verfügbar") als expr2 von productsales aus.

Gibt "ProductID" in der Spalte expr1, wertet die "Null"-Werte im Feld "Discount" aus und gibt "keine verfügbaren Details" für alle Nullwerte zurück (gibt die Werte ungleich NULL zurück, wie Sie ist).

Wählen Sie ProductID, NZ (Discount, "keine Details verfügbar") als ReplaceNull von productsales;

Gibt "ProductID" in Spalte Product zurück, wertet die "Null"-Werte im Feld "Discount" aus und gibt "keine verfügbaren Details" für alle Nullwerte zurück (gibt die Werte ungleich NULL zurück) und wird in der Spalte ReplaceNull angezeigt.

VBA-Beispiel

Hinweis: Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic for Applications). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerreferenz in der Dropdownliste neben Suchen aus, und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.

Im folgenden Beispiel wird ein Steuerelement in einem Formular ausgewertet, und es wird eine von zwei Zeichenfolgen basierend auf dem Wert des Steuerelements zurückgegeben. Wenn der Wert des Steuerelements nullist, wird in der Prozedur die NZ -Funktion verwendet, um einen null -Wert in eine leere Zeichenfolge zu konvertieren.

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

Hinweis:  Diese Seite wurde automatisiert übersetzt und kann Grammatikfehler oder Ungenauigkeiten enthalten. Unser Ziel ist es, Ihnen hilfreiche Inhalte bereitzustellen. Lassen Sie uns bitte wissen, ob diese Informationen hilfreich für Sie waren. Hier finden Sie den englischen Artikel als Referenz.

Ihre Office-Fähigkeiten erweitern
Schulungen erkunden
Neue Funktionen als Erster erhalten
Office Insider werden

War diese Information hilfreich?

Vielen Dank für Ihr Feedback!

Vielen Dank für Ihr Feedback. Es klingt, als ob es hilfreich sein könnte, Sie mit einem unserer Office-Supportmitarbeiter zu verbinden.

×