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.ShowするConsole.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は、 DataGridViewコントロールのプロパティDataSourceが設定されているか、 VirtualModeそのプロパティtrueがである場合にのみ発生します。The 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.

イベントは、 DataGridViewRow.ErrorTextプロパティの値が取得されるたびにも発生します。 RowErrorTextNeededThe 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.

大量のデータを処理するときにErrorText イベントを処理して、複数行の行の値を設定した場合のパフォーマンスの低下を回避します。RowErrorTextNeededHandle 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.

適用対象

こちらもご覧ください