DbParameter.SourceColumnNullMapping 속성

정의

소스 열에 null이 허용되는지 여부를 나타내는 값을 가져오거나 설정합니다. 이를 통해 DbCommandBuilder에서 null 허용 열에 대한 Update 문을 올바르게 생성할 수 있습니다.

public abstract bool SourceColumnNullMapping { get; set; }

속성 값

원본 열에 null이 허용되면 true이고, 허용되지 않으면 false입니다.

설명

SourceColumnNullMapping 는 에서 nullable 열을 처리할 때 업데이트 명령을 올바르게 생성하는 데 사용됩니다 DbCommandBuilder . 일반적으로 의 SourceColumnNullMapping 사용은 에서 DbCommandBuilder상속하는 개발자로 제한됩니다.

DbCommandBuilder 에서는 이 속성을 사용하여 원본 열이 null 허용인지 여부를 확인하고 이 속성을 true nullable인 경우 로 false 설정하고, 그렇지 않은 경우 로 설정합니다. 는 Update 문을 생성할 때 DbCommandBuilder 각 매개 변수에 대해 를 SourceColumnNullMapping 검사합니다. 속성이 이 trueDbCommandBuilder 면 다음과 같은 WHERE 절을 생성합니다(이 쿼리 식에서 "FieldName"은 필드 이름을 나타냅니다.).

((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
  (FieldName = @Original_FieldName))

필드 falseDbCommandBuilder 가 인 경우 SourceColumnNullMapping 는 다음 WHERE 절을 생성합니다.

FieldName = @OriginalFieldName

또한 @IsNull_FieldName 에는 원본 필드에 null이 포함되어 있으면 1, 그렇지 않으면 0을 포함합니다. 이 메커니즘은 SQL Server 성능 최적화를 허용하고 여러 공급자에서 작동하는 공통 코드를 제공합니다.

적용 대상

제품 버전
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

추가 정보