OracleParameter.SourceColumnNullMapping プロパティ

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

OracleParameter.SourceColumnNullMapping プロパティ

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

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

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

Visual Basic (宣言)

Public Overrides Property
 SourceColumnNullMapping As Boolean

Visual Basic (使用法)

Dim instance As OracleParameter
Dim value As Boolean

value = instance.SourceColumnNullMapping

instance.SourceColumnNullMapping = value

C#

public override bool SourceColumnNullMapping
 { get; set; }

C++

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

J#

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

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

JScript

public override function get
 SourceColumnNullMapping () : boolean

public override function set
 SourceColumnNullMapping (value : boolean)

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

解説

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

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

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

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

FieldName = @OriginalFieldName

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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