Class 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

รีเทิร์น

Booleantrue หากกฎอนุญาตให้ป้อนข้อมูลที่ตรวจสอบข้อมูลไม่ผ่าน และ 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 หากไม่ได้ตั้งค่าข้อความช่วยเหลือ