DataGridViewRowErrorTextNeededEventArgs クラス

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

RowErrorTextNeeded コントロールの DataGridView イベントのデータを提供します。

public ref class DataGridViewRowErrorTextNeededEventArgs : EventArgs
public class DataGridViewRowErrorTextNeededEventArgs : EventArgs
type DataGridViewRowErrorTextNeededEventArgs = class
    inherit EventArgs
Public Class DataGridViewRowErrorTextNeededEventArgs
Inherits EventArgs
継承
Object
EventArgs
DataGridViewRowErrorTextNeededEventArgs

例

次のコード例では、この型の使用方法を示します。 この例では、イベント ハンドラーはイベントの発生を RowErrorTextNeeded 報告します。 このレポートは、イベントがいつ発生するかを学習するのに役立ち、デバッグに役立ちます。 複数のイベント、または頻繁に発生するイベントに関するレポートを作成するには、メッセージを複数行TextBoxに置き換えるかShowConsole.WriteLine追加することを検討してください。

コード例を実行するには、名前付きのDataGridView1型DataGridViewのインスタンスを含むプロジェクトに貼り付けます。 次に、イベント ハンドラーがイベントに関連付けられていることを確認します RowErrorTextNeeded 。

private void DataGridView1_RowErrorTextNeeded(Object sender, DataGridViewRowErrorTextNeededEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "RowErrorTextNeeded Event" );
}

Private Sub DataGridView1_RowErrorTextNeeded(sender as Object, e as DataGridViewRowErrorTextNeededEventArgs) _ 
     Handles DataGridView1.RowErrorTextNeeded

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"RowErrorTextNeeded Event")

End Sub

注釈

このイベントはRowErrorTextNeeded、コントロール DataSource プロパティがDataGridView設定されているか、そのVirtualModeプロパティtrueが . イベントの RowErrorTextNeeded 処理は、その状態と含まれる値に応じて行のエラーを特定する場合に便利です。

イベントを RowErrorTextNeeded 処理し、ハンドラーでエラー テキストを指定すると、プロパティが設定されていない限り DataGridView.ShowRowErrors 、エラー グリフが行ヘッダーに false表示されます。 ユーザーがエラー グリフの上にマウス ポインターを移動すると、エラー テキストがツールヒントに表示されます。

このイベントは RowErrorTextNeeded 、プロパティの DataGridViewRow.ErrorText 値が取得されるたびに発生します。

このプロパティを RowIndex 使用して行の状態または値を特定し、この情報を使用してプロパティを ErrorText 変更または変更できます。 このプロパティは、イベント値がオーバーライドする row ErrorText プロパティの値で初期化されます。

大量のデータを RowErrorTextNeeded 操作するときにイベントを処理して、複数の行の行 ErrorText 値を設定するパフォーマンスの低下を回避します。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

イベントを処理する方法の詳細については、次を参照してください。処理とイベントの発生します。

プロパティ

ErrorText

行のエラー テキストを取得または設定します。
RowIndex

RowErrorTextNeeded イベントを発生させた行を取得します。

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

適用対象

こちらもご覧ください