DbParameter.SourceColumnNullMapping プロパティ

.NET Framework クラス ライブラリ リファレンス

DbParameter.SourceColumnNullMapping プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ソース列が null 許容であるかどうかを示す値を設定または取得します。DbCommandBuilder は、これを使用することにより、null 許容列に対する Update ステートメントを正しく生成できます。

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Property
 SourceColumnNullMapping As Boolean

Visual Basic (使用法)

Dim instance As DbParameter
Dim value As Boolean

value = instance.SourceColumnNullMapping

instance.SourceColumnNullMapping = value

C#

public abstract bool SourceColumnNullMapping
 { get; set; }

C++

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

J#

/** @property */
public abstract boolean get_SourceColumnNullMapping ()

/** @property */
public abstract void set_SourceColumnNullMapping
 (boolean value)

JScript

public abstract function get
 SourceColumnNullMapping () : boolean

public abstract function set
 SourceColumnNullMapping (value : boolean)

プロパティ値
ソース列が null 許容の場合は true。それ以外の場合は false。

解説

DbCommandBuilder は、null 許容列に対する更新コマンドを正しく生成するために、SourceColumnNullMapping を使用します。一般に、SourceColumnNullMapping を使用する機会は、DbCommandBuilder を継承する場合に限られます。

DbCommandBuilder は、ソース列が null 許容であるかどうかを判断するために、このプロパティを使用します。null 許容の場合、このプロパティは true に設定され、それ以外の場合は false に設定されます。DbCommandBuilder は、Update ステートメントを生成するとき、各パラメータについて SourceColumnNullMapping の値をチェックします。このプロパティが true の場合、DbCommandBuilder によって、次のような WHERE 句が生成されます。クエリ式の中で使用されている "FieldName" はフィールドの名前を表しています。

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

フィールドの SourceColumnNullMapping が false の場合、DbCommandBuilder によって、次のような WHERE 句が生成されます。

FieldName = @OriginalFieldName

また、ソース フィールドに null が含まれる場合、@IsNull_FieldName には 1 が格納され、それ以外の場合は 0 が格納されます。これにより、SQL Server のパフォーマンスが最適化されるほか、複数のプロバイダで共通で使用できるコードの生成が可能となります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DbParameter クラス
DbParameter メンバ
System.Data.Common 名前空間