.NET でデータ検証を扱う方法
Aspose.Cells FOSS for .NET は、Worksheet.Validations(ValidationCollection)を使用してセル範囲にデータ検証ルールを追加できます。Add(CellArea) を呼び出して Validation オブジェクトを作成し、ValidationType を使用してその Type を設定します。サポートされているタイプには List、Decimal、および Custom が含まれます。dotnet add package Aspose.Cells_FOSS でインストールします。
ステップバイステップ ガイド
ステップ 1: パッケージをインストール
dotnet add package Aspose.Cells_FOSSステップ 2: 名前空間をインポートする
using Aspose.Cells_FOSS;ステップ 3: リストドロップダウン検証を追加
CellArea を CellArea.CreateCellArea() で作成し、Worksheet.Validations に追加し、Formula1 にカンマ区切りリストで ValidationType.List を設定します。
using Aspose.Cells_FOSS;
var wb = new Workbook();
var ws = wb.Worksheets[0];
// Dropdown list for A1:A10
var listVal = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("A1", "A10"))];
listVal.Type = ValidationType.List;
listVal.Formula1 = "\"Open,In Progress,Closed\"";
listVal.InCellDropDown = true;
listVal.IgnoreBlank = true;
listVal.InputTitle = "Status";
listVal.InputMessage = "Choose a status from the dropdown";
wb.Save("list-validation.xlsx");
Console.WriteLine("List validation added.");ステップ 4: 数値範囲の検証を追加
ValidationType.Decimal と OperatorType.Between および Formula1/Formula2 を使用して数値入力を制限します。
using Aspose.Cells_FOSS;
var wb = new Workbook();
var ws = wb.Worksheets[0];
// Decimal range validation for B1:B10 — allow 0 to 100
var numVal = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("B1", "B10"))];
numVal.Type = ValidationType.Decimal;
numVal.Operator = OperatorType.Between;
numVal.Formula1 = "0";
numVal.Formula2 = "100";
numVal.ErrorTitle = "Out of Range";
numVal.ErrorMessage = "Please enter a number between 0 and 100.";
numVal.ShowError = true;
numVal.IgnoreBlank = true;
wb.Save("decimal-validation.xlsx");
Console.WriteLine("Decimal validation added.");ステップ5:同じシート上で複数の検証を組み合わせる
同じシートに任意の数の検証を追加するには、Validations.Add() を複数回呼び出し、各呼び出しで異なる CellArea を指定します。
using Aspose.Cells_FOSS;
var wb = new Workbook();
var ws = wb.Worksheets[0];
// List validation for column A (status)
var statusVal = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("A2", "A100"))];
statusVal.Type = ValidationType.List;
statusVal.Formula1 = "\"New,Open,Closed\"";
statusVal.InCellDropDown = true;
// Decimal validation for column B (score)
var scoreVal = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("B2", "B100"))];
scoreVal.Type = ValidationType.Decimal;
scoreVal.Operator = OperatorType.Between;
scoreVal.Formula1 = "0";
scoreVal.Formula2 = "10";
scoreVal.ShowError = true;
wb.Save("combined-validation.xlsx");
Console.WriteLine("Combined validations added to sheet.");一般的な問題と対処法
保存後にExcelでドロップダウンが表示されません。
保存する前に、InCellDropDown = true が Validation オブジェクトに設定されていることを確認してください。このフラグが true で、ValidationType.List が使用されている場合にのみ、Excelでドロップダウンが表示されます。
バリデーションは定義された範囲外の値も許可します。
バリデーションはライブラリではなく Excel によって強制されます。バリデーション ルールを設定しても、ライブラリ自体がセルに任意の値を書き込むことを防げません。バリデーションはユーザーが Excel でデータを入力したときに適用されます。
Formula1 のリスト検証では、Excel で #NAME? と表示されます。
インラインのカンマ区切りリストの場合、文字列をエスケープされた引用符で囲みます: Formula1 = "\"Option1,Option2,Option3\""。内部の引用符がないと、Excel はその値をセル参照の数式として扱います。
OperatorType.Between が正しく適用されていません。Formula1(最小)とFormula2(最大)の両方が文字列として設定されていることを確認してください。Between のための Formula2 が欠落していると、上限が未定義になります。
よくある質問
セル範囲(例: 名前付き範囲)に対して検証できますか?
Formula1 を "Sheet2!$A$1:$A$10" のようなセル範囲参照に設定します。その範囲の値はドロップダウンリストのソースとして使用されます。
検証はライブラリが無効な値を書き込むことを防ぎますか?
いいえ。検証ルールは、ユーザーがデータを入力したときに Excel によって適用されます。Aspose.Cells FOSS ライブラリは、プログラムで Cell.PutValue() を呼び出す際に検証を適用しません。
検証ルールを削除するにはどうすればよいですか?
Worksheet.Validations[index] を介してルールにアクセスし、ValidationCollection 操作を使用してルールを管理します。あるいは、不要なルールがない新しいワークブックモデルを作成します。
シートあたりの検証の最大数は何ですか?
XLSX 形式は、ワークシートごとに最大 65,530 件の検証ルールをサポートしています。