DataValidationJsonError

Class DataValidationJsonError

java.lang.Object

com.grapecity.documents.excel.JsonError

com.grapecity.documents.excel.DataValidationJsonError

---

public class DataValidationJsonError extends JsonError

表示与数据验证相关的 JSON 导入错误。

使用此类可以检查在 JSON 导入期间无法处理的数据验证条目的详细信息，例如包含错误的工作表、受影响的区域以及导致错误的验证内容。此类的实例可出现在 IWorkbook.fromJson(String) 返回的列表中。

 Workbook sourceWorkbook = new Workbook();
 IValidation validation = sourceWorkbook.getWorksheets().get(0).getRange("A1:A3").getValidation();
 validation.add(ValidationType.Custom, ValidationAlertStyle.Stop,
     ValidationOperator.Between, "=A1>0", null);
 String json = sourceWorkbook.toJson().replace("A1>0", "A1>");
 Workbook importedWorkbook = new Workbook();
 List<JsonError> errors = importedWorkbook.fromJson(json);
 DataValidationJsonError error = (DataValidationJsonError) errors.get(0);
 String range = error.getRange();
 

• Constructor Summary

  Constructors

  Constructor

  Description

  DataValidationJsonError(String errorMessage, String worksheetName, String range, String errorContent)

  使用指定详细信息创建数据验证 JSON 错误。

• Method Summary

  All MethodsInstance MethodsConcrete Methods

  Modifier and Type

  Method

  Description

  String

  getErrorContent()

  获取导致此 JSON 错误的数据验证内容。

  String

  getRange()

  获取与数据验证错误关联的单元格区域。

  String

  getWorksheetName()

  获取发生此数据验证 JSON 错误的工作表名称。

  Methods inherited from class com.grapecity.documents.excel.JsonError

  getErrorMessage

  Methods inherited from class java.lang.Object

  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

• Constructor Details

  • DataValidationJsonError

    public DataValidationJsonError(String errorMessage, String worksheetName, String range, String errorContent)

    使用指定详细信息创建数据验证 JSON 错误。

    Parameters:

    errorMessage - 错误消息。

    worksheetName - 工作表名称。

    range - 与错误关联的单元格区域。

    errorContent - 导致错误的数据验证内容。

• Method Details

  • getWorksheetName

    public String getWorksheetName()

    获取发生此数据验证 JSON 错误的工作表名称。

    此方法返回创建错误对象时存储在此 DataValidationJsonError 中的工作表名称。该值标识包含在 JSON 导入期间无法处理的数据验证条目的工作表。

    
     Workbook sourceWorkbook = new Workbook();
     IValidation validation = sourceWorkbook.getWorksheets().get(0).getRange("A1:A3").getValidation();
     validation.add(ValidationType.Custom, ValidationAlertStyle.Stop,
         ValidationOperator.Between, "=A1>0", null);
     String json = sourceWorkbook.toJson().replace("A1>0", "A1>");
     Workbook importedWorkbook = new Workbook();
     List<JsonError> errors = importedWorkbook.fromJson(json);
     DataValidationJsonError error = (DataValidationJsonError) errors.get(0);
     String worksheetName = error.getWorksheetName();
     

    Returns:

    与此错误关联的工作表名称。如果未存储工作表名称，则返回 null。

  • getRange

    public String getRange()

    获取与数据验证错误关联的单元格区域。

    此方法返回在导入 JSON 内容并检测到数据验证问题时为该数据验证错误记录的区域字符串。

    
     Workbook sourceWorkbook = new Workbook();
     IValidation validation = sourceWorkbook.getWorksheets().get(0).getRange("A1:A3").getValidation();
     validation.add(ValidationType.Custom, ValidationAlertStyle.Stop,
         ValidationOperator.Between, "=A1>0", null);
     String json = sourceWorkbook.toJson().replace("A1>0", "A1>");
     Workbook importedWorkbook = new Workbook();
     List<JsonError> errors = importedWorkbook.fromJson(json);
     DataValidationJsonError error = (DataValidationJsonError) errors.get(0);
     String range = error.getRange();
     

    Returns:

    数据验证错误的区域字符串。

  • getErrorContent

    public String getErrorContent()

    获取导致此 JSON 错误的数据验证内容。

    此方法返回为在 JSON 导入期间无法处理的数据验证条目捕获的验证内容，例如随错误详细信息存储的公式或其他验证定义。

    
     Workbook sourceWorkbook = new Workbook();
     IValidation validation = sourceWorkbook.getWorksheets().get(0).getRange("A1:A3").getValidation();
     validation.add(ValidationType.Custom, ValidationAlertStyle.Stop,
         ValidationOperator.Between, "=A1>0", null);
     String json = sourceWorkbook.toJson().replace("A1>0", "A1>");
     Workbook importedWorkbook = new Workbook();
     List<JsonError> errors = importedWorkbook.fromJson(json);
     DataValidationJsonError error = (DataValidationJsonError) errors.get(0);
     String errorContent = error.getErrorContent();
     

    Returns:

    与此错误关联的数据验证内容。如果未存储错误内容，则返回null。