DataGridViewRowErrorTextNeededEventArgs DataGridViewRowErrorTextNeededEventArgs DataGridViewRowErrorTextNeededEventArgs DataGridViewRowErrorTextNeededEventArgs Class

定義

RowErrorTextNeeded コントロールの DataGridView イベントのデータを提供します。Provides data for the RowErrorTextNeeded event of a DataGridView control.

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

次のコード例では、この型の使用を示します。The following code example demonstrates the use of this type. 例では、イベント ハンドラーが発生するときに報告、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. 複数のイベントまたは頻繁に発生するイベントを報告する、交換を検討ShowConsole.WriteLineまたはメッセージを複数行に追加TextBoxします。To report on multiple events or on events that occur frequently, consider replacing 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プロパティはtrueThe RowErrorTextNeeded event occurs only when the DataGridView control DataSource property 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イベント指定エラー テキスト ハンドラーで、行ヘッダーでエラー グリフが表示されます。 しない限り、DataGridView.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 DataGridView.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.

使用することができます、RowIndex状態または行の値を特定し、この情報を使用して、変更または変更するプロパティ、ErrorTextプロパティ。You can use the RowIndex property to determine the state or value of a row, and use this information to change or modify the 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.

プロパティ

ErrorText ErrorText ErrorText ErrorText

行のエラー テキストを取得または設定します。Gets or sets the error text for the row.

RowIndex RowIndex RowIndex RowIndex

RowErrorTextNeeded イベントを発生させた行を取得します。Gets the row that raised the RowErrorTextNeeded event.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください