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