DataGridViewDataErrorContexts 열거형

정의

데이터 오류가 발생한 경우에 데이터 바인딩된 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
상속
DataGridViewDataErrorContexts
특성

필드

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 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 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 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 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 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 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 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 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 8

행을 삭제할 때 데이터 오류가 발생했습니다.A data error occurred when deleting a row. 이 값은 데이터 바인딩된 DataGridView에서 행을 삭제하면 내부 데이터 저장소에서 예외를 throw함을 나타냅니다.This value indicates that the underlying data store threw an exception when a data-bound DataGridView deleted a row.

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 Forms 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

설명

데이터 바인딩된의 상태를 나타내는 비트 OR 연산을 사용 하 여이 열거형의 멤버를 결합할 수 있습니다 DataGridView 데이터 오류가 발생 합니다.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 시킵니다를 DataError 이벤트 인 Context 속성 커밋과 CurrentCellChange의 값이 포함 됩니다.When the commit fails, the DataGridView will raise a DataError event whose Context property will have a value of Commit and CurrentCellChange.

적용 대상

추가 정보