SqlParameter.SourceColumnNullMapping プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ソース列が 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, setPublic Overrides Property SourceColumnNullMapping As Booleanプロパティ値
ソース列が null 許容である場合は true。null 許容ではない場合は false。
注釈
SourceColumnNullMapping は、 が SqlCommandBuilder null 許容列を処理するときに更新コマンドを正しく生成するために使用されます。 一般に、 の SourceColumnNullMapping 使用は、 から SqlCommandBuilder継承する開発者に限定されます。
DbCommandBuilderでは、このプロパティを使用してソース列が null 許容かどうかを判断し、null 許容の場合は に、そうでない場合は false にtrue設定します。 Update ステートメントを生成するときに SqlCommandBuilder 、各パラメーターの を SourceColumnNullMapping 調べます。 プロパティが のSqlCommandBuilder場合、true次のような WHERE 句が生成されます (このクエリ式では、"FieldName" はフィールドの名前を表します)。
((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
(FieldName = @Original_FieldName))
フィールドの が false の場合 SourceColumnNullMapping 、 SqlCommandBuilder 次の WHERE 句が生成されます。
FieldName = @OriginalFieldName
さらに、 @IsNull_FieldName ソース フィールドに null が含まれている場合は 1、含まれていない場合は 0 が含まれます。 このメカニズムにより、SQL Serverでのパフォーマンスの最適化が可能になり、複数のプロバイダー間で動作する一般的なコードが提供されます。