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