Nz-Funktion

Wichtig :  Dieser Artikel wurde maschinell übersetzt. Bitte beachten Sie den Haftungsausschluss. Die englische Version des Artikels ist als Referenz hier verfügbar: hier.

Sie können die Nz -Funktion verwenden, um 0 (null), einer Leere Zeichenfolge zurückzukehren (""), oder einer anderen angegebenen Wert, wenn eine Variante ist Null. Beispielsweise können Sie diese Funktion verwenden, einen Nullwert in einen anderen Wert konvertieren und verhindern, dass er durch einen Ausdruck verbreitet.

Syntax

Nz ( Variante [; WertWennNull ] )

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

Argument

Beschreibung

Variant-Variable

Erforderlich. Eine Variable des Datentyps Variant.

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 das Argument Variant-Variable den Wert NULL hat, gibt die Nz-Funktion abhängig davon, ob der Kontext angibt, dass der Wert eine Zahl oder eine Zeichenfolge sein muss, die Zahl 0 oder eine Zeichenfolge der Länge null zurück (bei Verwendung in einem Abfrageausdruck gibt die Funktion immer eine Zeichenfolge der Länge null zurück). Ist das optionale Argument WertWennNULL angegeben, gibt die Nz-Funktion den in diesem Argument angegebenen Wert zurück, wenn das Argument Variant-Variable gleich NULL ist. Wenn die Funktion in einem Abfrageausdruck verwendet wird, sollte die NZ-Funktion das Argument WertWennNULL immer enthalten.

Hat Variant-Variable nicht den Wert NULL, gibt die Nz-Funktion den Wert von Variant-Variable zurück.

Hinweise

Die Nz-Funktion ist für Ausdrücke nützlich, die NULL-Werte enthalten können. Soll erzwungen werden, dass ein Ausdruck selbst dann, wenn er einen NULL-Wert enthält, zu einem Wert ungleich NULL ausgewertet wird, verwenden Sie die Nz-Funktion, um 0, eine Zeichenfolge der Länge null oder einen benutzerdefinierten Wert zurückzugeben.

Beispielsweise gibt der Ausdruck 2 + varX immer einen NULL-Wert zurück, wenn die Variant-Variable varX gleich NULL ist. 2 + Nz(varX) gibt dagegen 2 zurück.

Sie können die Nz-Funktion häufig als Alternative zur IIf-Funktion verwenden. Im folgenden Code sind beispielsweise zwei Ausdrücke, die die IIf-Funktion enthalten, erforderlich, um das gewünschte Ergebnis zurückzugeben. Mit dem ersten Ausdruck, der die IIf-Funktion enthält, wird der Wert einer Variablen geprüft und in 0 konvertiert, wenn er gleich NULL ist.

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

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

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

Wenn Sie einen Wert für das optionale Argument WertWennNULL angeben, wird dieser Wert zurückgegeben, wenn Variant-Variable gleich NULL ist. Durch Einfügen dieses optionalen Arguments können Sie möglicherweise darauf verzichten, einen Ausdruck verwenden zu müssen, der die IIf-Funktion enthält. Beispielsweise wird im folgenden Ausdruck die IIf-Funktion verwendet, um eine Zeichenfolge zurückzugeben, wenn der Wert von varFreight gleich NULL ist.

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

Im nächsten Beispiel enthält das optional Argument, das in der Nz-Funktion angegeben ist, die Zeichenfolge, die zurückgegeben werden soll, wenn varFreight gleich NULL ist.

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

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 auf einem Formular ausgewertet und entsprechend dem Wert des Steuerelements eine von zwei Zeichenfolgen zurückgegeben. Hat das Steuerelement den Wert NULL, wird in der Prozedur die Nz-Funktion verwendet, um den Wert NULL in eine Zeichenfolge der Länge null 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 : Haftungsausschluss für maschinelle Übersetzungen: Dieser Artikel wurde mithilfe eines Computersystems und ohne jegliche Bearbeitung durch Personen übersetzt. Microsoft bietet solche maschinellen Übersetzungen als Hilfestellung für Benutzer ohne Englischkenntnisse an, damit Sie von den Informationen zu Produkten, Diensten und Technologien von Microsoft profitieren können. Da es sich bei diesem Artikel um eine maschinelle Übersetzung handelt, enthält er möglicherweise Fehler in Bezug auf (Fach-)Terminologie, Syntax und/oder Grammatik.

Teilen Facebook Facebook Twitter Twitter E-Mail E-Mail

War diese Information hilfreich?

Sehr gut. Noch anderes Feedback?

Was können wir verbessern?

Vielen Dank für Ihr Feedback!

×