Valores null y en blanco en los complementos de Excel

null y las cadenas vacías tienen implicaciones especiales en las API de JavaScript de Excel. Se usan para representar celdas vacías, sin formato o valores predeterminados. En esta sección se detalla el uso de null y la cadena vacía al obtener y establecer propiedades.

Entrada NULL en una matriz bidimensional

En Excel, un intervalo se representa mediante una matriz de 2-D, donde la primera dimensión son las filas y la segunda dimensión son las columnas. Para establecer valores, formato de número o fórmulas solo para celdas específicas dentro de un rango, especifique los valores, formato de número o fórmula para las celdas de la matriz 2D y especifique null para todas las demás celdas de la matriz 2D.

Por ejemplo, para actualizar el formato de número solo para una celda dentro de un rango y conservar el formato de número existente para todas las demás celdas del rango, especifique el nuevo formato de número de la celda que va a actualizar y especifique null para todas las demás celdas. El fragmento de código siguiente establece un nuevo formato de número para la cuarta celda del rango y deja sin cambios el formato de número de las tres primeras celdas del rango.

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

entrada NULL para una propiedad

null no es una entrada válida para la propiedad única. Por ejemplo, el siguiente fragmento de código no es válido, ya que la values propiedad del intervalo no se puede establecer en null.

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

Asimismo, el siguiente fragmento de código no es válido, como nulltampoco lo es el valor de la propiedadcolor.

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

valores de la propiedad NULL en la respuesta

Las propiedades de formato como size y color contendrán valores null en la respuesta cuando existan distintos valores en el intervalo especificado. Por ejemplo, si recupera un rango y carga su propiedad format.font.color:

• Si todas las celdas del rango tienen el mismo color de fuente, range.format.font.color especifica ese color.
• Si hay varios colores de fuente dentro del rango, range.format.font.color es null.

Entrada en blanco para una propiedad

Cuando se especifica un valor en blanco para una propiedad (es decir, dos pares de comillas sin espacios intermedios ''), se interpretará como una instrucción para borrar o restablecer la propiedad. Por ejemplo:

• Si se especifica un valor en blanco para la propiedad values de un rango, se borra el contenido del rango.
• Si se especifica un valor en blanco para la propiedad numberFormat, se restablece el formato de número a General.
• Si se especifica un valor en blanco para la propiedad formula y la propiedad formulaLocale, los valores de la fórmula se borrarán.

Valores de la propiedad en blanco en la respuesta

Para las operaciones de lectura, un valor de una propiedad en blanco en la respuesta (es decir, dos pares de comillas sin espacios intermedios '') indica que la celda no contiene datos ni valor. En el primer ejemplo, la primera y la última celda del rango no contienen datos. En el segundo ejemplo, las dos primeras celdas del rango no contienen una fórmula.

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

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