RegexPattern プロパティ

セル値が一致する必要がある正規表現を取得または設定します。検証が成功するためには、セルのテキストのすべての文字が一致部分に含まれる必要があります。

シンタックス

Visual Basic

'宣言
 
Public Property RegexPattern As String

C#

public string RegexPattern {get; set;}

解説

このプロパティに指定した正規表現は、列のセル値の検証に使用されます。ユーザーがセルから入力フォーカスを移動しようとすると、セルのテキストが正規表現に対して検証されます。検証が成功するためには、セルのテキスト全体が 1 つの一致を構成する必要があります。セルのテキストが部分的に一致していても、その一致部分の他に文字がある場合、検証は失敗します。たとえば、正規表現が "\d{2}" (これは数字が 2 つ連続することを意味します) で、セルのテキストが "12" の場合、検証は成功します。しかし、セルのテキストが "123" の場合、検証は失敗します。これは、一致部分 ("12") の後に余分な数字 ("3") があるためです。この動作を変更するには、正規表現の先頭または末尾に ".*" を付けます。これは、一致部分の前または後に任意の数の文字があってもよいことを意味します。

使用例

Visual Basic

Private Sub SetupGrid()
   ' Create a regular expression pattern which only matches a sequence of characters that starts
   ' with one to three digits followed by a single character.
   ' That is the pattern required for Order IDs in this example.
   '
   Dim strRegex As String = "\d{1,3}\w"
   
   ' Assign the regular expression pattern to the RegexPattern property of the OrderID column.
   '
   Me.ultraGrid1.DisplayLayout.Bands("Orders").Columns("OrderID").RegexPattern = strRegex
End Sub

C#

private void SetupGrid()
{
	// Create a regular expression pattern which only matches a sequence of characters that starts
	// with one to three digits followed by a single character.
	// That is the pattern required for Order IDs in this example.
	//
	string strRegex = @"\d{1,3}\w";

	// Assign the regular expression pattern to the RegexPattern property of the OrderID column.
	//
	this.ultraGrid1.DisplayLayout.Bands["Orders"].Columns["OrderID"].RegexPattern = strRegex;
}