.NET でデータ検証を扱う方法

.NET でデータ検証を扱う方法

Aspose.Cells FOSS for .NET は、Worksheet.ValidationsValidationCollection)を使用してセル範囲にデータ検証ルールを追加できます。Add(CellArea) を呼び出して Validation オブジェクトを作成し、ValidationType を使用してその Type を設定します。サポートされているタイプには ListDecimal、および Custom が含まれます。dotnet add package Aspose.Cells_FOSS でインストールします。

ステップバイステップ ガイド

ステップ 1: パッケージをインストール

dotnet add package Aspose.Cells_FOSS

ステップ 2: 名前空間をインポートする

using Aspose.Cells_FOSS;

ステップ 3: リストドロップダウン検証を追加

CellAreaCellArea.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.DecimalOperatorType.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 = trueValidation オブジェクトに設定されていることを確認してください。このフラグが 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 件の検証ルールをサポートしています。

参照

 日本語