Leer- und Nullwerte in Excel-Add-ins

null und leere Zeichenfolgen haben besondere Auswirkungen in den Excel-JavaScript-APIs. Sie werden verwendet, um leere Zellen, fehlende Formatierungen oder Standardwerte darzustellen. In diesem Abschnitt wird die Verwendung von null und einer leeren Zeichenfolge beim Abrufen und Festlegen von Eigenschaften beschrieben.

NULL-Eingabe im 2D-Array

In Excel wird ein Bereich durch ein 2D-Array dargestellt, in dem die erste Dimension die Zeilen und die zweite Dimension die Spalten umfasst. Wenn Sie Werte, Nummernformate oder Formeln nur für bestimmte Zellen eines Bereichs festlegen möchten, geben Sie die Werte, Nummernformate oder Formeln für diese Zellen in das 2D-Array ein und legen Sie null für alle anderen Zellen des 2D-Arrays fest.

Wenn Sie das Nummernformat z. B. nur für eine Zelle eines Bereichs aktualisieren und für alle anderen Zellen des Bereichs das vorhandene Nummernformat beibehalten möchten, geben Sie das neue Nummernformat für die Zelle, die aktualisiert werden soll, und null für alle anderen Zellen an. Der folgende Codeausschnitt gibt ein neues Nummernformat für die vierte Zelle im Bereich an, und das Nummernformat für die ersten drei Zellen im Bereich bleibt dabei unverändert.

range.values = [['Eurasia', '29.96', '0.25', '15-Feb' ]];
range.numberFormat = [[null, null, null, 'm/d/yyyy;@']];

NULL-Eingabe für eine Eigenschaft

null ist keine gültige Eingabe für eine einzelne Eigenschaft. Der folgende Codeausschnitt ist beispielsweise ungültig, da die values -Eigenschaft des Bereichs nicht auf nullfestgelegt werden kann.

range.values = null; // This is not a valid snippet. 

Der folgende Codeausschnitt ist ebenso ungültig, da null kein gültiger Wert für die color-Eigenschaft ist.

range.format.fill.color =  null;  // This is not a valid snippet. 

NULL-Eigenschaft-Werte in der Antwort

Formatierungseigenschaften wie size und colorenthalten null-Werte in der Antwort, wenn unterschiedliche Werte im angegebenen Bereich vorhanden sind. Wenn Sie z. B. einen Bereich Abrufen und die format.font.color-Eigenschaft laden:

• Wenn alle Zellen im Bereich die gleichen Schriftfarbe besitzen, gibt range.format.font.color diese Farbe an.
• Wenn mehrere Schriftfarben im Bereich vorhanden sind, ist range.format.font.colornull.

Leere Eingabe für eine Eigenschaft

Wenn Sie einen leeren Wert für eine Eigenschaft angeben (d. h. zwei Anführungszeichen ohne Leerzeichen dazwischen ''), wird dies als Anweisung zum Löschen oder Zurücksetzen der Eigenschaft interpretiert. Beispiel:

• Wenn Sie einen leeren Wert für die values -Eigenschaft eines Bereichs angeben, wird der Inhalt des Bereichs gelöscht.
• Wenn Sie einen leeren Wert für die numberFormat -Eigenschaft angeben, wird das Nummernformat auf General zurückgesetzt.
• Wenn Sie einen leeren Wert für die formulaEigenschaft und die formulaLocale-Eigenschaft angeben, werden die Formelwert gelöscht.

Leere Eigenschaftswerte in der Antwort

Bei Lesevorgängen bedeutet ein leerer Eigenschaftswert in der Antwort (d. h. zwei Anführungszeichen ohne Leerzeichen dazwischen ''), dass die Zelle keine Daten oder keinen Wert enthält. Im ersten Beispiel unten enthalten die erste und die letzte Zelle im Bereich keine Daten. Im zweiten Beispiel enthalten die ersten beiden Zellen im Bereich keine Formel.

range.values = [['', 'some', 'data', 'in', 'other', 'cells', '']];

range.formula = [['', '', '=Rand()']];