DataGridViewCell.ErrorText プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataGridViewCell.ErrorText プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

セルに関連付けられたエラー条件を記述するテキストを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property ErrorText As
 String

Visual Basic (使用法)

Dim instance As DataGridViewCell
Dim value As String

value = instance.ErrorText

instance.ErrorText = value

public string ErrorText { get;
 set; }

C++

public:
property String^ ErrorText {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ErrorText ()

/** @property */
public void set_ErrorText (String value)

JScript

public function get ErrorText
 () : String

public function set ErrorText
 (value : String)

プロパティ値
セルに関連付けられたエラー条件を記述するテキスト。

解説

通常、ErrorText プロパティは、DataGridView の CellValidating イベントを処理する際に使用されます。セル値が特定の妥当性検査の基準を満たしていない場合、ErrorText プロパティを設定し、DataGridViewCellValidatingEventArgs の Cancel プロパティを true に設定することでコミット操作をキャンセルします。その後、指定したテキストが DataGridView に表示され、ユーザーにセルのデータのエラー修正を求めるダイアログボックスが表示されます。

DataGridView の VirtualMode プロパティが true の場合、RowErrorTextNeeded イベントおよび CellErrorTextNeeded イベントを使用して、行とセルのエラーテキストを提供できます。

別の ErrorText 文字列をセルに割り当てると、DataGridView コントロールの CellErrorTextChanged イベントが発生します。

使用例

非バインドの DataGridView でエラー条件を処理する際にこのプロパティを使用する方法を次のコード例に示します。AnnotateCell メソッドが、エラーメッセージ文字列を ErrorText プロパティに設定します。

Visual Basic

Private Sub dataGridView1_CellValidating(ByVal
 sender As Object, _
    ByVal e As _
    DataGridViewCellValidatingEventArgs) _
    Handles dataGridView1.CellValidating

    Dim column As DataGridViewColumn = _
        dataGridView1.Columns(e.ColumnIndex)

    If column.Name = "Track" Then
        CheckTrack(e)
    ElseIf column.Name = "Release Date"
 Then
        CheckDate(e)
    End If
End Sub

Private Shared Sub CheckTrack(ByVal
 newValue As DataGridViewCellValidatingEventArgs)
    If String.IsNullOrEmpty(newValue.FormattedValue.ToString())
 Then
        NotifyUserAndForceRedo("Please enter a track",
 newValue)
    ElseIf Not Integer.TryParse(
 _
        newValue.FormattedValue.ToString(), New Integer())
 Then
        NotifyUserAndForceRedo("A Track must be a number",
 newValue)
    ElseIf Integer.Parse(newValue.FormattedValue.ToString())
 < 1 Then
        NotifyUserAndForceRedo("Not a valid track",
 newValue)
    End If
End Sub

Private Shared Sub NotifyUserAndForceRedo(ByVal
 errorMessage As String, ByVal
 newValue As DataGridViewCellValidatingEventArgs)
    MessageBox.Show(errorMessage)
    newValue.Cancel = True
End Sub

Private Sub CheckDate(ByVal
 newValue As DataGridViewCellValidatingEventArgs)
    Try
        DateTime.Parse(newValue.FormattedValue.ToString()).ToLongDateString()
        AnnotateCell(String.Empty, newValue)
    Catch ex As FormatException
        AnnotateCell("You did not enter a valid date.",
 newValue)
    End Try
End Sub

Private Sub AnnotateCell(ByVal
 errorMessage As String, _
    ByVal editEvent As DataGridViewCellValidatingEventArgs)

    Dim cell As DataGridViewCell = _
        dataGridView1.Rows(editEvent.RowIndex).Cells( _
            editEvent.ColumnIndex)
    cell.ErrorText = errorMessage
End Sub

private void dataGridView1_CellValidating(object
 sender, DataGridViewCellValidatingEventArgs e)
{

    DataGridViewColumn column = dataGridView1.Columns[e.ColumnIndex];

    if (column.Name == "Track")
    {
        CheckTrack(e);
    }
    else if (column.Name == "Release Date")
    {
        CheckDate(e);
    }
}

private static void CheckTrack(DataGridViewCellValidatingEventArgs
 newValue)
{
    Int32 ignored = new Int32();
    if (String.IsNullOrEmpty(newValue.FormattedValue.ToString()))
    {
        NotifyUserAndForceRedo("Please enter a track", newValue);
    }
    else if (!Int32.TryParse(newValue.FormattedValue.ToString(),
 out ignored))
    {
        NotifyUserAndForceRedo("A Track must be a number", newValue);
    }
    else if (Int32.Parse(newValue.FormattedValue.ToString())
 < 1)
    {
        NotifyUserAndForceRedo("Not a valid track", newValue);
    }
}

private static void NotifyUserAndForceRedo(string
 errorMessage, DataGridViewCellValidatingEventArgs newValue)
{
    MessageBox.Show(errorMessage);
    newValue.Cancel = true;
}

private void CheckDate(DataGridViewCellValidatingEventArgs
 newValue)
{
    try
    {
        DateTime.Parse(newValue.FormattedValue.ToString()).ToLongDateString();
        AnnotateCell(String.Empty, newValue);
    }
    catch (FormatException)
    {
        AnnotateCell("You did not enter a valid date.", newValue);
    }
}

private void AnnotateCell(string
 errorMessage, DataGridViewCellValidatingEventArgs editEvent)
{

    DataGridViewCell cell = dataGridView1.Rows[editEvent.RowIndex].Cells[editEvent.ColumnIndex];
    cell.ErrorText = errorMessage;
}

C++

void dataGridView1_CellValidating( Object^ /*sender*/, DataGridViewCellValidatingEventArgs^
 newValue )
{
   DataGridViewColumn^ column = dataGridView1->Columns[ newValue->ColumnIndex
 ];
   if ( column->Name->Equals( "Track" ) )
   {
      CheckTrack( newValue );
   }
   else
   if ( column->Name->Equals( "Release Date" )
 )
   {
      CheckDate( newValue );
   }
}

void CheckTrack( DataGridViewCellValidatingEventArgs^ newValue
 )
{
   Int32 ignored;
   if ( newValue->FormattedValue->ToString() == String::Empty
 )
   {
      NotifyUserAndForceRedo( "Please enter a track", newValue );
   }
   else
   if (  !Int32::TryParse( newValue->FormattedValue->ToString(),
 ignored ) )
   {
      NotifyUserAndForceRedo( "A Track must be a number", newValue );
   }
   else
   if ( Int32::Parse( newValue->FormattedValue->ToString()
 ) < 1 )
   {
      NotifyUserAndForceRedo( "Not a valid track", newValue );
      editedLastColumn = true;
   }
}

void NotifyUserAndForceRedo( String^ errorMessage, DataGridViewCellValidatingEventArgs^
 newValue )
{
   MessageBox::Show( errorMessage );
   newValue->Cancel = true;
}

void CheckDate( DataGridViewCellValidatingEventArgs^ newValue
 )
{
   try
   {
      DateTime::Parse( newValue->FormattedValue->ToString() ).ToLongDateString();
      AnnotateCell( String::Empty, newValue );
   }
   catch ( FormatException^ /*ex*/ ) 
   {
      AnnotateCell( "You did not enter a valid date.", newValue );
   }
}

void AnnotateCell( String^ errorMessage, DataGridViewCellValidatingEventArgs^
 editEvent )
{
   DataGridViewCell^ cell = dataGridView1->Rows[ editEvent->RowIndex ]->Cells[
 editEvent->ColumnIndex ];
   cell->ErrorText = errorMessage;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewCell クラス
DataGridViewCell メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewCellValidatingEventArgs
DataGridView.CellValidating イベント
DataGridView.VirtualMode プロパティ
DataGridView.RowErrorTextNeeded イベント
DataGridView.CellErrorTextNeeded イベント
DataGridView.CellErrorTextChanged イベント
CancelEventArgs.Cancel

>> 「DataGridViewCell.ErrorText プロパティ」を含む用語の索引
DataGridViewCell.ErrorText プロパティのページへのリンク

DataGridViewCell.ErrorText プロパティとは？わかりやすく解説

DataGridViewCell.ErrorText プロパティ

「DataGridViewCell.ErrorText プロパティ」の関連用語


	© 2025 Microsoft.All rights reserved.

DataGridViewCell.ErrorText プロパティとは？ わかりやすく解説

DataGridViewCell.ErrorText プロパティ

「DataGridViewCell.ErrorText プロパティ」の関連用語

DataGridViewCell.ErrorText プロパティとは？わかりやすく解説