DataGridViewDataErrorContexts 列挙体とは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataGridViewDataErrorContexts 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

データエラー発生時のデータ連結 DataGridView コントロールの状態を表します。

この列挙体には、メンバ値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。

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

Visual Basic (宣言)

<FlagsAttribute> _
Public Enumeration DataGridViewDataErrorContexts

Visual Basic (使用法)

Dim instance As DataGridViewDataErrorContexts

[FlagsAttribute] 
public enum DataGridViewDataErrorContexts

C++

[FlagsAttribute] 
public enum class DataGridViewDataErrorContexts

/** @attribute FlagsAttribute() */ 
public enum DataGridViewDataErrorContexts

JScript

FlagsAttribute 
public enum DataGridViewDataErrorContexts

メンバ

	メンバ名	説明
	ClipboardContent	内容をクリップボードにコピーするときに、データエラーが発生しました。この値は、セル値を文字列に変換できなかったことを示します。
	Commit	変更をデータストアにコミットするときに、データエラーが発生しました。この値は、セルに入力されたデータを基になるデータソースにコミットできなかったことを示します。
	CurrentCellChange	選択ポインタを別のセルに移動したときに、データエラーが発生しました。この値は、以前に選択されていたセルがエラー状態のときに、ユーザーがセルを選択したことを示します。
	Display	データソースによって値が設定されたセルを表示するときに、データエラーが発生しました。この値は、データソースのデータをセルに表示できないか、データソースからの値をセル用に変換するマップが欠落していることを示します。
	Formatting	データストアに送信されるデータ、またはデータストアから読み込まれるデータの書式を指定するときに、データエラーが発生しました。この値は、セルの変更で、正しい書式設定ができなかったことを示します。新しいセル値を修正するか、セルの書式設定を変更する必要があります。
	InitialValueRestoration	セルを前の値に戻すときに、データエラーが発生しました。この値は、セルの編集を取り消して、初期値にロールバックしようとしたときに、失敗したことを示します。これは、セルの書式設定が変更され、初期値と互換性がなくなった場合に発生する可能性があります。
	LeaveControl	DataGridView がフォーカスを失ったときに、データエラーが発生しました。この値は、DataGridView がフォーカスを失った後、ユーザーの変更をコミットできなかったことを示します。
	Parsing	新しいデータを解析するときに、データエラーが発生しました。この値は、ユーザーが入力したか、基になるデータソースから読み込んだ新しいデータを DataGridView が解析できなかったことを示します。
	PreferredSize	セルの推奨サイズを計算するときに、データエラーが発生しました。この値は、列または行のサイズをプログラムによって変更するときに、DataGridView がセルの幅や高さの推奨値を計算できなかったことを示します。これは、セルが値の書式を設定できなかった場合に発生する可能性があります。
	RowDeletion	行を削除するときに、データエラーが発生しました。この値は、データ連結 DataGridView が行を削除したときに、基になるデータストアが例外をスローしたことを示します。
	Scroll	新しい領域をビューにスクロールしたときに、データエラーが発生しました。この値は、データエラーのあるセルを、プログラムまたはスクロールバーによって、ビューにスクロールしたことを示します。

解説

この列挙体のメンバをビットごとの OR 演算を使用して結合し、データエラー発生時のデータ連結 DataGridView の状態を表すことができます。たとえば、ユーザーがセルに無効な値を入力し (日付を入力するセルに名前を入力するなど)、他のセルを選択すると、DataGridView は無効なセル値をコミットしようとします。コミットに失敗すると、DataGridView では DataError イベントが発生します。Context プロパティの値は Commit および CurrentCellChange になります。

使用例

この型の使用方法を次のコード例に示します。次の例は「方法 : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーを処理する」で取り上げている例の一部です。

Visual Basic

Private Sub dataGridView1_DataError(ByVal
 sender As Object, _
    ByVal e As DataGridViewDataErrorEventArgs)
 _
    Handles dataGridView1.DataError

    ' If the data source raises an exception when a cell value is 
    ' commited, display an error message.
    If Not e.Exception Is
 Nothing AndAlso _
        e.Context = DataGridViewDataErrorContexts.Commit Then

        MessageBox.Show("CustomerID value must be unique.")

    End If

End Sub

private void dataGridView1_DataError(object
 sender,
    DataGridViewDataErrorEventArgs e)
{
    // If the data source raises an exception when a cell value is 
    // commited, display an error message.
    if (e.Exception != null &&
        e.Context == DataGridViewDataErrorContexts.Commit)
    {
        MessageBox.Show("CustomerID value must be unique.");
    }
}