文字列の長さの検証（TextLengthValidator）

TextLengthValidatorを使用すると、セルの値の長さが指定した範囲に収まっているかどうかを検証できます。値の長さが指定した範囲に含まれない場合、検証エラーになります。

デザイナによる設定

デザイナで文字列の長さの検証を設定するには、次のように操作します。

値を検証するセルを選択する。(例: textBoxCell1)
プロパティウィンドウでValidatorsプロパティを選択し、［...］ボタンをクリックする。
表示されたCellValidatorコレクションエディタで左上のコンボボックスから「TextLengthValidator」を選択し、［追加］をクリックする。
[メンバ]リストでTextLengthValidatorが選択されていることを確認する。
画面右のプロパティグリッドでEncodingプロパティを選択し、「日本語 (シフト JIS)」を選択する。
画面右のプロパティグリッドでLengthUnitプロパティを選択し、「Byte」を選択する。
画面右のプロパティグリッドでMaximumLengthプロパティを選択し、「5」を入力する。
画面右のプロパティグリッドでActionsプロパティを選択し、［...］ボタンをクリックする。
表示されたCellValidateActionコレクションエディタでLineNotifyを追加する。
［OK］ボタンをクリックしてCellValidateActionコレクションエディタを閉じる。
［OK］ボタンをクリックしてCellValidatorコレクションエディタを閉じる。
デザイナのドキュメントウィンドウのタブを「実行時」に切り替える。
「あああ」と入力してセルを移動したときに検証エラーになることを確認する。
「あああ」を消して「AAA」を入力して移動したときに検証エラーにならないことを確認する。

コーディングによる設定

次のコードは、セルに5バイトより大きい文字列が入力されたときに検証エラーを表示します。

Visual Basic
C#

Imports GrapeCity.Win.MultiRow

Dim TextBoxCell1 As New TextBoxCell()
Dim TextLengthValidator1 As New TextLengthValidator()
TextLengthValidator1.Encoding = System.Text.Encoding.GetEncoding("Shift-JIS")
TextLengthValidator1.LengthUnit = LengthUnit.Byte
TextLengthValidator1.MaximumLength = 5
TextLengthValidator1.Actions.Add(New LineNotify())
TextBoxCell1.Validators.Add(TextLengthValidator1)

Dim cells As Cell() = {TextBoxCell1}
GcMultiRow1.Template = Template.CreateGridTemplate(cells)
GcMultiRow1.RowCount = 10

using GrapeCity.Win.MultiRow;

TextBoxCell textBoxCell1 = new TextBoxCell();
TextLengthValidator textLengthValidator1 = new TextLengthValidator();
textLengthValidator1.Encoding = System.Text.Encoding.GetEncoding("Shift_JIS");
textLengthValidator1.LengthUnit = LengthUnit.Byte;
textLengthValidator1.MaximumLength = 5;
textLengthValidator1.Actions.Add(new LineNotify());
textBoxCell1.Validators.Add(textLengthValidator1);

Cell[] cells = { textBoxCell1 };
gcMultiRow1.Template = Template.CreateGridTemplate(cells);
gcMultiRow1.RowCount = 10;