DataGridViewDataErrorContexts DataGridViewDataErrorContexts DataGridViewDataErrorContexts DataGridViewDataErrorContexts Enum

定義

データ エラー発生時のデータ連結 DataGridView コントロールの状態を表します。Represents the state of a data-bound DataGridView control when a data error occurred.

この列挙型には FlagsAttribute 属性があり、メンバー値ではビットごとの組み合わせを使用できます。

public enum class DataGridViewDataErrorContexts
[System.Flags]
public enum DataGridViewDataErrorContexts
type DataGridViewDataErrorContexts = 
Public Enum DataGridViewDataErrorContexts
継承
DataGridViewDataErrorContextsDataGridViewDataErrorContextsDataGridViewDataErrorContextsDataGridViewDataErrorContexts
属性

フィールド

ClipboardContent ClipboardContent ClipboardContent ClipboardContent 16384

内容をクリップボードにコピーするときに、データ エラーが発生しました。A data error occurred when copying content to the Clipboard. この値は、セル値を文字列に変換できなかったことを示します。This value indicates that the cell value could not be converted to a string.

Commit Commit Commit Commit 512

変更をデータ ストアにコミットするときに、データ エラーが発生しました。A data error occurred when committing changes to the data store. この値は、セルに入力されたデータを基になるデータ ソースにコミットできなかったことを示します。This value indicates that data entered in a cell could not be committed to the underlying data store.

CurrentCellChange CurrentCellChange CurrentCellChange CurrentCellChange 4096

選択ポインターを別のセルに移動したときに、データ エラーが発生しました。A data error occurred when the selection cursor moved to another cell. この値は、以前に選択されていたセルがエラー状態のときに、ユーザーがセルを選択したことを示します。This value indicates that a user selected a cell when the previously selected cell had an error condition.

Display Display Display Display 2

データ ソースによって値が設定されたセルを表示するときに、データ エラーが発生しました。A data error occurred when displaying a cell that was populated by a data source. この値は、データ ソースのデータをセルに表示できないか、データ ソースからの値をセル用に変換するマップが欠落していることを示します。This value indicates that the value from the data source cannot be displayed by the cell, or a mapping that translates the value from the data source to the cell is missing.

Formatting Formatting Formatting Formatting 1

データ ストアに送信されるデータ、またはデータ ストアから読み込まれるデータの書式を指定するときに、データ エラーが発生しました。A data error occurred when trying to format data that is either being sent to a data store, or being loaded from a data store. この値は、セルの変更で、正しい書式設定ができなかったことを示します。This value indicates that a change to a cell failed to format correctly. 新しいセル値を修正するか、セルの書式設定を変更する必要があります。Either the new cell value needs to be corrected or the cell's formatting needs to change.

InitialValueRestoration InitialValueRestoration InitialValueRestoration InitialValueRestoration 1024

セルを前の値に戻すときに、データ エラーが発生しました。A data error occurred when restoring a cell to its previous value. この値は、セルの編集を取り消して、初期値にロールバックしようとしたときに、失敗したことを示します。This value indicates that a cell tried to cancel an edit and the rollback to the initial value failed. これは、セルの書式設定が変更され、初期値と互換性がなくなった場合に発生する可能性があります。This can occur if the cell formatting changed so that it is incompatible with the initial value.

LeaveControl LeaveControl LeaveControl LeaveControl 2048

DataGridView がフォーカスを失ったときに、データ エラーが発生しました。A data error occurred when the DataGridView lost focus. この値は、DataGridView がフォーカスを失った後、ユーザーの変更をコミットできなかったことを示します。This value indicates that the DataGridView could not commit user changes after losing focus.

Parsing Parsing Parsing Parsing 256

新しいデータを解析するときに、データ エラーが発生しました。A data error occurred when parsing new data. この値は、ユーザーが入力したか、基になるデータ ソースから読み込んだ新しいデータを DataGridView が解析できなかったことを示します。This value indicates that the DataGridView could not parse new data that was entered by the user or loaded from the underlying data store.

PreferredSize PreferredSize PreferredSize PreferredSize 4

セルの推奨サイズを計算するときに、データ エラーが発生しました。A data error occurred when calculating the preferred size of a cell. この値は、列または行のサイズをプログラムによって変更するときに、DataGridView がセルの幅や高さの推奨値を計算できなかったことを示します。This value indicates that the DataGridView failed to calculate the preferred width or height of a cell when programmatically resizing a column or row. これは、セルが値の書式を設定できなかった場合に発生する可能性があります。This can occur if the cell failed to format its value.

RowDeletion RowDeletion RowDeletion RowDeletion 8

行を削除するときに、データ エラーが発生しました。A data error occurred when deleting a row. この値は、データ連結 DataGridView が行を削除したときに、基になるデータ ストアが例外をスローしたことを示します。This value indicates that the underlying data store threw an exception when a data-bound DataGridView deleted a row.

Scroll Scroll Scroll Scroll 8192

新しい領域をビューにスクロールしたときに、データ エラーが発生しました。A data error occurred when scrolling a new region into view. この値は、データ エラーのあるセルを、プログラムまたはスクロール バーによって、ビューにスクロールしたことを示します。This value indicates that a cell with data errors scrolled into view programmatically or with the scroll bar.

この型の使用方法を次のコード例に示します。The following code example illustrates the use of this type. この例は、次の方法で使用できる大きな例の一部です。Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーを処理します。This example is part of a larger example available in How to: Handle Errors That Occur During Data Entry in the Windows Forms DataGridView Control.

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.");
    }
}
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 e.Exception IsNot Nothing AndAlso _
        e.Context = DataGridViewDataErrorContexts.Commit Then

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

    End If

End Sub

注釈

この列挙体のメンバーは、データエラーが発生したときにデータバインドDataGridViewの状態を表すために、ビットごとの or 演算を使用して組み合わせることができます。Members of this enumeration may be combined using the bitwise OR operation to represent the state of a data-bound DataGridView when a data error occurred. たとえば、ユーザーが無効なセル値 (日付を期待するセルに名前を入力するなど) を入力し、別のセルDataGridViewを選択した場合、は無効なセル値のコミットを試行します。For example, if a user enters an invalid cell value (such as entering a name in a cell that expects a date) and then selects a different cell, the DataGridView will try to commit the invalid cell value. コミットが失敗すると、 DataGridViewによってDataErrorContextプロパティの値が commit および currentcellchange になるイベントが発生します。When the commit fails, the DataGridView will raise a DataError event whose Context property will have a value of Commit and CurrentCellChange.

適用対象

こちらもご覧ください