방법: 열 변경 중 데이터 유효성 검사

데이터 유효성 검사는 응용 프로그램의 데이터에 입력할 값을 확인하는 과정입니다. 업데이트를 기본 데이터 저장소에 보내기 전에 이러한 값을 확인하면 응용 프로그램과 데이터 저장소 간에 발생할 수 있는 잠재적 라운드트립 횟수를 줄일 수 있습니다.

참고

데이터 집합 디자이너는 데이터 집합에 유효성 검사 논리를 추가할 수 있는 partial 클래스를 만듭니다. 디자이너에서 생성한 데이터 집합은 partial 클래스의 코드를 삭제하거나 변경하지 않습니다. 자세한 내용은 방법: 데이터 집합의 기능 확장을 참조하십시오.

ColumnChanging 이벤트에 응답하여 데이터 열의 값이 변경될 때 데이터의 유효성 검사를 할 수 있습니다. 이 이벤트는 발생될 때 현재 열에 대한 제안 값이 포함된 이벤트 인수(ProposedValue)를 전달합니다. e.ProposedValue의 내용에 따라 다음을 할 수 있습니다.

  • 아무런 작업도 수행하지 않고 제안된 값을 받아들입니다.

  • 열 변경 이벤트 처리기에서 열 오류(SetColumnError)를 설정하여 제안된 값을 거부합니다.

  • 선택에 따라 ErrorProvider 컨트롤을 사용하여 사용자에게 오류 메시지를 표시할 수 있습니다. 자세한 내용은 ErrorProvider 구성 요소(Windows Forms)를 참조하십시오.

RowChanging 이벤트 동안 유효성 검사를 수행할 수도 있습니다. 자세한 내용은 방법: 행 변경 중 데이터 유효성 검사를 참조하십시오.

열 값이 변경될 때 데이터의 유효성을 검사하려면

  1. 데이터 집합 디자이너에서 데이터 집합을 엽니다. 자세한 내용은 방법: 데이터 집합 디자이너에서 데이터 집합 열기를 참조하십시오.

  2. 유효성을 검사할 열을 두 번 클릭합니다. 이렇게 하면 DataTableColumnChanging 이벤트 처리기가 만들어집니다.

    참고

    데이터 집합 디자이너에서는 C# 이벤트에 대한 이벤트 처리기가 자동으로 만들어지지 않습니다. 이벤트를 처리하는 데 필요한 코드가 아래에 포함되어 있습니다.

  3. e.ProposedValue에 응용 프로그램의 요구 사항에 맞는 데이터가 들어 있는지 확인하는 코드를 추가합니다. 제안된 값이 적합하지 않으면 오류가 있음을 나타내도록 열을 설정합니다.

    다음 코드 예제에서는 Quantity 열이 0보다 작거나 같을 때 열 오류를 설정합니다. 열 변경 이벤트 처리기는 다음과 같습니다.

    'Visual Basic
    Private Sub Order_DetailsDataTable_ColumnChanging(ByVal sender As System.Object, ByVal e As System.Data.DataColumnChangeEventArgs) _
        Handles Me.ColumnChanging
    
        If (e.Column.ColumnName = Me.QuantityColumn.ColumnName) Then
    
            If CType(e.ProposedValue, Short) <= 0 Then
            e.Row.SetColumnError(e.Column, "Quantity must be greater than 0")
        Else
            e.Row.SetColumnError(e.Column, "")
            End If
        End If
    End Sub
    
    // C#
    // Add this code to the DataTable 
    // partial class.
        public override void EndInit()
        {
            base.EndInit();
            ColumnChanging += SampleColumnChangingEvent;
        }
    
        public void SampleColumnChangingEvent(object sender, System.Data.DataColumnChangeEventArgs e)
        {
            if (e.Column.ColumnName == QuantityColumn.ColumnName)
            {
                if ((short)e.ProposedValue <= 0)
                {
                    e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
                }
                else
                {
                    e.Row.SetColumnError("Quantity", "");
                }
            }
        }
    

참고 항목

작업

연습: Windows Form에 데이터 표시

방법: Windows Forms DataGridView 컨트롤의 데이터 유효성 검사

방법: Windows Forms ErrorProvider 구성 요소를 사용하여 폼 유효성에 대한 오류 아이콘 표시

방법: 데이터베이스의 데이터에 연결

참조

데이터 소스 창

개념

TableAdapter 개요

데이터 집합 디자이너

데이터 소스 개요

기타 리소스

데이터 유효성 검사