Freigeben über


ExcelScript.ReplaceCriteria interface

Stellt die zu verwendenden Ersetzungskriterien dar.

Eigenschaften

completeMatch

Gibt an, ob die Übereinstimmung vollständig oder teilweise sein muss. Eine vollständige Übereinstimmung entspricht dem gesamten Inhalt der Zelle. Eine partielle Übereinstimmung entspricht einer Teilzeichenfolge innerhalb des Zellinhalts (z. cat B. teilweise übereinstimmungen caterpillar und scatter). Der Standardwert ist false (partielle).

matchCase

Gibt an, ob bei der Übereinstimmung die Groß-/Kleinschreibung beachtet wird. Der Standardwert ist false (ohne Berücksichtigung der Groß-/Kleinschreibung).

Details zur Eigenschaft

completeMatch

Gibt an, ob die Übereinstimmung vollständig oder teilweise sein muss. Eine vollständige Übereinstimmung entspricht dem gesamten Inhalt der Zelle. Eine partielle Übereinstimmung entspricht einer Teilzeichenfolge innerhalb des Zellinhalts (z. cat B. teilweise übereinstimmungen caterpillar und scatter). Der Standardwert ist false (partielle).

completeMatch?: boolean;

Eigenschaftswert

boolean

Beispiele

/**
 * 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

Gibt an, ob bei der Übereinstimmung die Groß-/Kleinschreibung beachtet wird. Der Standardwert ist false (ohne Berücksichtigung der Groß-/Kleinschreibung).

matchCase?: boolean;

Eigenschaftswert

boolean

Beispiele

/**
 * 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);
}