エクスポート (0) 印刷
すべて展開

DataGridViewRowErrorTextNeededEventArgs クラス

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

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

public class DataGridViewRowErrorTextNeededEventArgs : EventArgs
public class DataGridViewRowErrorTextNeededEventArgs extends EventArgs
public class DataGridViewRowErrorTextNeededEventArgs extends EventArgs
適用できません。

RowErrorTextNeeded イベントが発生するのは、DataGridView コントロールの DataSource プロパティが設定されているか、VirtualMode プロパティが true の場合のみです。RowErrorTextNeeded イベントの処理は、行の状態および行に含まれる値に応じて、行のエラーを判断する場合に便利です。

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

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

RowIndex プロパティを使用すると、行の状態または値を確認でき、この情報を使用して ErrorText プロパティを変更または修正できます。このプロパティは、行の ErrorText プロパティの値によって初期化され、イベントの値によってオーバーライドされます。

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

イベント処理の詳細については、「イベントの利用」を参照してください。

この型の使用方法を次のコード例に示します。この例では、イベント ハンドラが RowErrorTextNeeded イベントの発生について報告します。このレポートによって、イベントがいつ発生したかを認識できるため、デバッグの際に役立ちます。複数のイベントまたは頻繁に発生するイベントについて報告するには、ShowSystem.Console.WriteLine に置き換えるか、複数行 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" );
}

System.Object
   System.EventArgs
    System.Windows.Forms.DataGridViewRowErrorTextNeededEventArgs

この型の public static (Visual Basicでは共有) メンバはすべて,スレッド セーフです。インスタンス メンバの場合は,スレッド セーフであるとは限りません。

Windows 98,Windows Server 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

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

.NET Framework

サポート対象 : 3.0,2.0

コミュニティの追加

追加
表示:
© 2014 Microsoft