หน้านี้ได้รับการแปลโดย Cloud Translation API

Class DataValidation

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

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var 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`	รับประเภทเกณฑ์ของกฎตามที่กำหนดไว้ใน enum ของ `DataValidationCriteria`
`getCriteriaValues()`	`Object[]`	รับอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์ของกฎ
`getHelpText()`	`String`	รับข้อความช่วยเหลือของกฎ หรือ`null`หากไม่มีการตั้งค่าข้อความช่วยเหลือ

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

`copy()`

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

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

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

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var 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()`

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

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var 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 ถ้าไม่ได้ตั้งค่าข้อความช่วยเหลือไว้