DataGridView.RowErrorTextNeeded DataGridView.RowErrorTextNeeded DataGridView.RowErrorTextNeeded DataGridView.RowErrorTextNeeded Event

定義

行のエラー テキストが必要な場合に発生します。Occurs when a row's error text is needed.

public:
 event System::Windows::Forms::DataGridViewRowErrorTextNeededEventHandler ^ RowErrorTextNeeded;
public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler RowErrorTextNeeded;
member this.RowErrorTextNeeded : System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler 
Public Custom Event RowErrorTextNeeded As DataGridViewRowErrorTextNeededEventHandler 

次のコード例では、このメンバーの使用を示します。The following code example demonstrates the use of this member. 例では、イベント ハンドラーが発生するときに報告、RowErrorTextNeededイベント。In the example, an event handler reports on the occurrence of the RowErrorTextNeeded event. このレポートでは、イベントが発生してデバッグに役立つについて説明します。This report helps you to learn when the event occurs and can assist you in debugging. 複数のイベントまたは頻繁に発生するイベントを報告する、交換を検討MessageBox.ShowConsole.WriteLineまたはメッセージを複数行に追加TextBoxします。To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

コード例を実行する型のインスタンスを含むプロジェクトに貼り付けることDataGridViewというDataGridView1します。To run the example code, paste it into a project that contains an instance of type DataGridView named DataGridView1. イベント ハンドラーに関連付けられていることを確認し、RowErrorTextNeededイベント。Then ensure that the event handler is associated with the RowErrorTextNeeded event.

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プロパティはtrueThe RowErrorTextNeeded event occurs only when the DataSource property of the DataGridView control is set or its VirtualMode property is true. 処理、RowErrorTextNeededイベントは、その状態とが含まれている値に応じて、行のエラーを確認する場合に便利です。Handling the RowErrorTextNeeded event is useful when you want to determine the error for a row depending on its state and the values it contains.

処理するとき、RowErrorTextNeededイベント指定エラー テキスト ハンドラーで、行ヘッダーでエラー グリフが表示されます。 しない限り、ShowRowErrorsプロパティに設定されてfalseします。When you handle the RowErrorTextNeeded event and specify error text in the handler, an error glyph appears in the row header unless the ShowRowErrors property is set to false. エラー グリフ上、マウス ポインターを移動すると、エラー テキストがツールヒントに表示されます。When the user moves the mouse pointer over the error glyph, the error text appears in a ToolTip.

RowErrorTextNeededたびにイベントにも発生の値、DataGridViewRow.ErrorTextプロパティを取得します。The RowErrorTextNeeded event also occurs whenever the value of the DataGridViewRow.ErrorText property is retrieved.

使用することができます、DataGridViewRowErrorTextNeededEventArgs.RowIndex行またはそれに含まれる値の状態を確認して、この情報を使用して、変更または変更するプロパティ、DataGridViewRowErrorTextNeededEventArgs.ErrorTextプロパティ。You can use the DataGridViewRowErrorTextNeededEventArgs.RowIndex property to determine the state of a row or the values it contains, and use this information to change or modify the DataGridViewRowErrorTextNeededEventArgs.ErrorText property. このプロパティは、行の値で初期化されますErrorTextプロパティで、イベント値より優先されます。This property is initialized with the value of the row ErrorText property, which the event value overrides.

処理、RowErrorTextNeeded大量のデータ行の設定のパフォーマンスの低下を回避するために使用する場合、イベントErrorText複数行の値。Handle the RowErrorTextNeeded event when working with large amounts of data to avoid the performance penalties of setting the row ErrorText value for multiple rows. 詳細については、次を参照してください。 Windows フォーム DataGridView コントロールを拡張するためのベスト プラクティスします。For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

イベントを処理する方法の詳細については、次を参照してください。処理とイベントの発生します。For more information about how to handle events, see Handling and Raising Events.

適用対象

こちらもご覧ください