SqlParameter.SourceColumnNullMapping 속성

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

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

public:
 virtual property bool SourceColumnNullMapping { bool get(); void set(bool value); };

public override bool SourceColumnNullMapping { get; set; }

member this.SourceColumnNullMapping : bool with get, set

Public Overrides Property SourceColumnNullMapping As Boolean

속성 값

Boolean

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

설명

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

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

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

에 대한 필드가 false SqlCommandBuilder 이면 SourceColumnNullMapping 는 다음 WHERE 절을 생성합니다.

FieldName = @OriginalFieldName  

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