ExcelScript.ReplaceCriteria interface

Paquete:

ExcelScript

Representa los criterios de reemplazo que se van a usar.

Propiedades

completeMatch	Especifica si la coincidencia debe ser completa o parcial. Una coincidencia completa coincide con todo el contenido de la celda. Una coincidencia parcial coincide con una subcadena dentro del contenido de la celda (por ejemplo, cat coincidencias parciales caterpillar y scatter). El valor predeterminado es false (parcial).
matchCase	Especifica si la coincidencia distingue mayúsculas de minúsculas. El valor predeterminado es false (no distingue mayúsculas de minúsculas).

Detalles de las propiedades

completeMatch

Especifica si la coincidencia debe ser completa o parcial. Una coincidencia completa coincide con todo el contenido de la celda. Una coincidencia parcial coincide con una subcadena dentro del contenido de la celda (por ejemplo, cat coincidencias parciales caterpillar y scatter). El valor predeterminado es false (parcial).

completeMatch?: boolean;

Valor de propiedad

boolean

Ejemplos

/**
 * This script normalizes the text in a column so that values don't include both "OK" and "okay". 
 * It replaces "OK" and all the case-based variants with "okay".
 */ 
function main(workbook: ExcelScript.Workbook) {
  // Get the range representing column D.
  const currentSheet = workbook.getActiveWorksheet();
  const column = currentSheet.getRange("D:D");

  // Create a ReplaceCriteria object for the Range.replaceAll call.
  const criteria: ExcelScript.ReplaceCriteria = {
    completeMatch: true, /* Use a complete match to skip cells that already say "okay". */
    matchCase: false /* Ignore case when comparing strings. */
  };

  // Replace all instances of "ok" (case-insensitive) with "okay".
  column.replaceAll("ok", "okay", criteria);
}

matchCase

Especifica si la coincidencia distingue mayúsculas de minúsculas. El valor predeterminado es false (no distingue mayúsculas de minúsculas).

matchCase?: boolean;

Valor de propiedad

boolean

Ejemplos

/**
 * This script replaces instances of "NA" with "North America", 
 * using the casing to ignore parts of words.
 */ 
function main(workbook: ExcelScript.Workbook) {
  // Get the currently used range.
  const currentSheet = workbook.getActiveWorksheet();
  const usedRange = currentSheet.getUsedRange();

  // Create a ReplaceCriteria object for the Range.replaceAll call.
  const criteria: ExcelScript.ReplaceCriteria = {
    completeMatch: false, 
    matchCase: true /* Match with "NA market", not "navigate" */
  }

  // Replace all instances of "NA" (case-sensitive) with "North America".
  usedRange.replaceAll("NA", "North America", criteria);
}