Class DataValidation

DataValidation

เข้าถึงกฎการตรวจสอบข้อมูล หากต้องการสร้างกฎใหม่ ให้ใช้ SpreadsheetApp.newDataValidation() และ DataValidationBuilder คุณใช้ Range.setDataValidation(rule) เพื่อตั้งกฎการตรวจสอบสำหรับช่วงได้ 

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.');
}

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
copy()DataValidationBuilderสร้างเครื่องมือสร้างสำหรับกฎการตรวจสอบข้อมูลตามการตั้งค่าของกฎนี้
getAllowInvalid()Booleanแสดงผล true หากกฎแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูล หรือ false หากปฏิเสธอินพุตทั้งหมด
getCriteriaType()DataValidationCriteriaรับประเภทเกณฑ์ของกฎตามที่กำหนดไว้ใน DataValidationCriteria enum
getCriteriaValues()Object[]รับอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์ของกฎ
getHelpText()Stringรับข้อความช่วยเหลือของกฎ หรือ null หากไม่ได้ตั้งค่าข้อความช่วยเหลือ

เอกสารโดยละเอียด

copy()

สร้างเครื่องมือสร้างสำหรับกฎการตรวจสอบข้อมูลตามการตั้งค่าของกฎนี้ 

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const args = rule.getCriteriaValues();

      if (criteria === SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN &&
          args[0].getTime() === oldDates[0].getTime() &&
          args[1].getTime() === oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

รีเทิร์น

DataValidationBuilder - ตัวสร้างที่อิงตามการตั้งค่าของกฎนี้

getAllowInvalid()

แสดงผล true หากกฎแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูล หรือ false หากปฏิเสธอินพุตทั้งหมด ค่าเริ่มต้นสำหรับกฎการตรวจสอบข้อมูลใหม่คือ true

รีเทิร์น

Boolean — true หากกฎอนุญาตให้ป้อนข้อมูลที่ตรวจสอบไม่ผ่าน false หากไม่

getCriteriaType()

รับประเภทเกณฑ์ของกฎตามที่กำหนดไว้ใน DataValidationCriteria enum หากต้องการรับอาร์กิวเมนต์สำหรับเกณฑ์ ให้ใช้ getCriteriaValues() หากต้องการใช้ค่าเหล่านี้เพื่อสร้างหรือ แก้ไขกฎการตรวจสอบข้อมูล โปรดดูDataValidationBuilder.withCriteria(criteria, args) 

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.');
}

รีเทิร์น

DataValidationCriteria - ประเภทของเกณฑ์การตรวจสอบข้อมูล

getCriteriaValues()

รับอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์ของกฎ หากต้องการรับประเภทเกณฑ์ ให้ใช้ getCriteriaType() หากต้องการใช้ค่าเหล่านี้เพื่อสร้างหรือแก้ไขกฎการตรวจสอบข้อมูล โปรดดูDataValidationBuilder.withCriteria(criteria, args) 

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.');
}

รีเทิร์น

Object[] - อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะสมกับประเภทเกณฑ์ของกฎ จำนวนอาร์กิวเมนต์ และประเภทของอาร์กิวเมนต์ตรงกับเมธอด require...() ที่สอดคล้องกันของคลาส DataValidationBuilder

getHelpText()

รับข้อความช่วยเหลือของกฎ หรือ null หากไม่ได้ตั้งค่าข้อความช่วยเหลือ

รีเทิร์น

String — ข้อความช่วยเหลือของกฎ หรือ null หากไม่ได้ตั้งค่าข้อความช่วยเหลือ