DataGridViewDataErrorContexts 列挙体

.NET Framework 4.5

その他のバージョン

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

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

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

構文

C++

[FlagsAttribute]
public enum DataGridViewDataErrorContexts

メンバー

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

解説

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

例

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


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.");
    }
}

バージョン情報

.NET Framework

サポート対象 : 4.5、4、3.5、3.0、2.0

.NET Framework Client Profile

サポート対象 : 4、3.5 SP1

プラットフォーム

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (サーバーコアロールはサポート対象外), Windows Server 2008 R2 (SP1 以降でサーバーコアロールをサポート。Itanium はサポート対象外)

.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

参照

コミュニティの追加

追加

DataGridViewDataErrorContexts 列挙体

.NET Framework

.NET Framework Client Profile

関連項目

コミュニティの追加