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 発生を報告します。 このレポートは、イベントが発生したタイミングを確認するのに役立ち、デバッグに役立ちます。 複数のイベントまたは頻繁に発生するイベントを報告するには、 を Console.WriteLine に置き換えるかShow、複数行TextBoxにメッセージを追加することを検討してください。

コード例を実行するには、 という名前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)

適用対象

こちらもご覧ください