OleDbParameter.SourceColumnNullMapping OleDbParameter.SourceColumnNullMapping OleDbParameter.SourceColumnNullMapping OleDbParameter.SourceColumnNullMapping Property

定義

ソース列が null 許容かどうかを示す値を設定または取得します。Sets or gets a value which indicates whether the source column is nullable. これにより、DbCommandBuilder で null 許容列の Update ステートメントを正しく生成できます。This allows DbCommandBuilder to correctly generate Update statements for nullable columns.

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 許容ではない場合は falsetrue if the source column is nullable; false if it is not.

注釈

SourceColumnNullMapping 使って、DbCommandBuilderを null 許容列を処理するときに、更新コマンドを正しく生成します。SourceColumnNullMapping is used by the DbCommandBuilder to correctly generate update commands when dealing with nullable columns. 一般の使用SourceColumnNullMappingから継承する開発者に制限されてDbCommandBuilderします。Generally, use of SourceColumnNullMapping is limited to developers inheriting from DbCommandBuilder.

DbCommandBuilder このプロパティを使用して、基になる列が、null 値は、このプロパティを設定かどうかを判断するtrue、null 許容である場合とfalseでない場合。DbCommandBuilder uses this property to determine whether the source column is nullable, and sets this property to true if it is nullable, and false if it is not. ときにDbCommandBuilderが調べ、Update ステートメントを生成する、SourceColumnNullMappingパラメーターごとにします。When DbCommandBuilder is generating its Update statement, it examines the SourceColumnNullMapping for each parameter. プロパティが場合trueDbCommandBuilder次のような WHERE 句が生成されます (このクエリ式では"FieldName"を表すフィールドの名前)。If the property is true, DbCommandBuilder generates a WHERE clauses like the following (in this query expression, "FieldName" represents the name of the field):

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

場合SourceColumnNullMappingフィールドが false の場合のDbCommandBuilder次の WHERE 句が生成されます。If SourceColumnNullMapping for the field is false, DbCommandBuilder generates the following WHERE clause:

FieldName = @OriginalFieldName  

さらに、@IsNull_FieldNameそうでない場合、null と 0 をソース フィールドが存在する場合、1 が含まれています。In addition, @IsNull_FieldName contains 1 if the source field contains null, and 0 if it does not. このメカニズムでは、SQL server のパフォーマンスを最適化でき、複数のプロバイダーで動作する一般的なコードを提供します。This mechanism allows for a performance optimization in SQL Server, and provides for common code that works across multiple providers.

適用対象

こちらもご覧ください