엔터티 클래스에 유효성 검사 추가

아티클
02/16/2024

참고 항목

데이터 집합 및 관련 클래스는 2000년대 초반에 적용된 레거시 .NET Framework 기술로, 응용 프로그램이 데이터베이스에서 연결이 끊어진 동안 응용 프로그램이 메모리의 데이터로 작업할 수 있도록 합니다. 해당 기술은 사용자가 데이터를 수정하고 변경 내용을 다시 데이터베이스에 유지할 수 있도록 하는 애플리케이션에 특히 유용합니다. 데이터 세트는 매우 성공적인 기술로 입증되었지만 새 .NET 애플리케이션은 Entity Framework Core를 사용하는 것이 좋습니다. Entity Framework는 표 형식 데이터를 개체 모델로 사용하는 더 자연스러운 방법을 제공하며 더 단순한 프로그래밍 인터페이스를 제공합니다.

엔터티 클래스의 유효성 검사는 데이터 개체에 입력된 값이 개체의 스키마 제약 조건과 애플리케이션에 대해 설정된 규칙을 따르는지 확인하는 과정입니다. 업데이트를 내부 데이터베이스에 보내기 전에 데이터의 유효성을 검사하면 오류를 줄일 수 있습니다. 또한 애플리케이션과 데이터베이스 간에 발생할 수 있는 잠재적 라운드트립 횟수를 줄일 수 있습니다.

Visual Studio의 LINQ to SQL 도구에서는 사용자가 전체 엔터티를 삽입, 업데이트, 삭제하는 동안 실행되고 개별 열이 변경되는 동안과 그 후에도 실행되는 디자이너에서 생성한 코드를 확장할 수 있는 부분 메서드를 제공합니다.

참고 항목

이 항목에서는 O/R 디자이너를 사용하여 엔터티 클래스에 유효성 검사를 추가하는 기본 단계를 설명합니다. 특정 엔터티 클래스를 참조하지 않고 이 일반 단계를 따르는 것이 어려울 수 있으므로 실제 데이터를 사용하는 연습이 제공됩니다.

특정 열의 값에 변경 내용에 대한 유효성 검사 추가

이 절차는 열의 값이 변경될 때 데이터의 유효성을 검사하는 방법을 보여 줍니다. 유효성 검사는 사용자 인터페이스 대신 클래스 정의 내에서 수행되기 때문에 값에 대한 유효성 검사가 실패하면 예외가 throw됩니다. 애플리케이션에서 열 값을 변경하려고 하는 코드에 대한 오류 처리를 구현하세요.

참고 항목

이 문서의 일부 Visual Studio 사용자 인터페이스 요소에 대한 다른 이름 또는 위치가 컴퓨터에 표시될 수 있습니다. 다른 버전의 Visual Studio 또는 다른 환경 설정을 사용 중일 수 있습니다. 자세한 내용은 IDE 개인 설정을 참조하세요.

열의 값을 변경하는 동안 데이터의 유효성을 검사하려면

O/R 디자이너에서 새 LINQ to SQL 클래스 파일(.dbml 파일)을열거나 만듭니다. ( 솔루션 탐색기에서 .dbml 파일을 두 번 클릭합니다.)
O/R 디자이너에서 유효성 검사를 추가할 클래스를 마우스 오른쪽 단추로 클릭한 다음, 코드 보기를 선택합니다.

선택한 엔터티 클래스의 partial 클래스와 함께 코드 편집기가 열립니다.
커서를 partial 클래스에 놓습니다.
Visual Basic 프로젝트의 경우
1. 메서드 이름 목록을 확장합니다.
2. 유효성 검사를 추가할 열에 대해 OnCOLUMNNAMEChanging 메서드를 찾습니다.
3. OnCOLUMNNAMEChanging 메서드가 partial 클래스에 추가됩니다.
4. 다음 코드를 추가하여 입력된 값을 먼저 확인한 다음 열에 입력된 값이 애플리케이션에서 허용되는지 확인합니다. 다음 value 인수는 제안된 값을 포함하고 있으므로 이를 유효한 값으로 확인하는 논리를 추가합니다.
```
If value.HasValue Then
    ' Add code to ensure that the value is acceptable.
    ' If value < 1 Then
    '    Throw New Exception("Invalid data!")
    ' End If
End If
```
C# 프로젝트의 경우:

C# 프로젝트는 이벤트 처리기를 자동으로 생성하지 않기 때문에 IntelliSense를 사용하여 열 변경 부분 메서드를 만들 수 있습니다. partial을 입력한 다음 사용 가능한 부분 메서드에 액세스하기 위한 공간을 입력합니다. 유효성 검사를 추가할 열에 대해 열 변경 메서드를 클릭합니다. 다음 코드는 열 변경 부분 메서드를 선택할 때 생성되는 코드와 비슷합니다.
```
partial void OnCOLUMNNAMEChanging(COLUMNDATATYPE value)
    {
       throw new System.NotImplementedException();
    }
```

엔터티 클래스의 업데이트에 대한 유효성 검사 추가

변경하는 동안 값을 검사하는 작업 이외에도 전체 엔터티 클래스에 대해 업데이트를 시도할 때 데이터의 유효성을 검사할 수도 있습니다. 비즈니스 규칙에서 여러 열의 값에 대한 비교를 요구하는 경우 업데이트를 시도하는 동안 유효성 검사가 해당 작업을 수행합니다. 다음 절차는 전체 엔터티 클래스를 업데이트하려고 할 때 유효성을 검사하는 방법을 보여 줍니다.

참고 항목

전체 엔터티 클래스 업데이트에 대한 유효성 검사 코드는 특정 엔터티 클래스의 partial 클래스가 아니라 partial DataContext 클래스에서 실행됩니다.

엔터티 클래스에 대한 업데이트 동안 데이터의 유효성을 검사하려면

O/R 디자이너에서 새 LINQ to SQL 클래스 파일(.dbml 파일)을열거나 만듭니다. ( 솔루션 탐색기에서 .dbml 파일을 두 번 클릭합니다.)
O/R 디자이너에서 마우스 오른쪽 단추로 빈 영역을 클릭하고 코드 보기를 클릭합니다.

DataContext의 partial 클래스와 함께 코드 편집기가 열립니다.
커서를 DataContext의 partial 클래스에 놓습니다.
Visual Basic 프로젝트의 경우
1. 메서드 이름 목록을 확장합니다.
2. UpdateENTITYCLASSNAME를 클릭합니다.
3. UpdateENTITYCLASSNAME 메서드가 partial 클래스에 추가됩니다.
4. 다음 코드에 표시된 것과 같은 instance 인수를 사용하여 개별 열 값에 액세스합니다.
```
If (instance.COLUMNNAME = x) And (instance.COLUMNNAME = y) Then
    Dim ErrorMessage As String = "Invalid data!"
    Throw New Exception(ErrorMessage)
End If
```
C# 프로젝트의 경우:

C# 프로젝트는 이벤트 처리기를 자동으로 생성하지 않기 때문에 IntelliSense를 사용하여 부분 UpdateCLASSNAME 메서드를 만들 수 있습니다. partial을 입력한 다음 사용 가능한 부분 메서드에 액세스하기 위한 공간을 입력합니다. 유효성 검사를 추가하려는 클래스의 업데이트 메서드를 클릭합니다. 다음 코드는 UpdateCLASSNAME 부분 메서드를 선택할 때 생성되는 코드와 비슷합니다.
```
partial void UpdateCLASSNAME(CLASSNAME instance)
{
    if ((instance.COLUMNNAME == x) && (instance.COLUMNNAME = y))
    {
        string ErrorMessage = "Invalid data!";
        throw new System.Exception(ErrorMessage);
    }
}
```

다음을 통해 공유

엔터티 클래스에 유효성 검사 추가

특정 열의 값에 변경 내용에 대한 유효성 검사 추가

열의 값을 변경하는 동안 데이터의 유효성을 검사하려면

엔터티 클래스의 업데이트에 대한 유효성 검사 추가

엔터티 클래스에 대한 업데이트 동안 데이터의 유효성을 검사하려면

피드백

추가 리소스

다음을 통해 공유

엔터티 클래스에 유효성 검사 추가

특정 열의 값에 변경 내용에 대한 유효성 검사 추가

열의 값을 변경하는 동안 데이터의 유효성을 검사하려면

엔터티 클래스의 업데이트에 대한 유효성 검사 추가

엔터티 클래스에 대한 업데이트 동안 데이터의 유효성을 검사하려면

관련 콘텐츠

피드백

추가 리소스