SqlParameter.SourceColumnNullMapping プロパティ
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ソース列が Null 許容かどうかを示す値を取得または設定します。 これにより、SqlCommandBuilder で 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, setPublic Overrides Property SourceColumnNullMapping As Booleanソース列が null 許容である場合は true。null 許容ではない場合は false。
SourceColumnNullMapping は、 で SqlCommandBuilder null 許容列を処理するときに更新コマンドを正しく生成するために使用されます。 一般に、 の SourceColumnNullMapping 使用は から SqlCommandBuilder継承する開発者に限定されます。
DbCommandBuilderでは、このプロパティを使用してソース列が null 許容かどうかを判断し、null 許容の場合は に、falseそうでない場合は にこのプロパティtrueを設定します。 Update ステートメントを生成するときに SqlCommandBuilder 、各パラメーターの を SourceColumnNullMapping 調べます。 プロパティが のSqlCommandBuilder場合、true次のような WHERE 句が生成されます (このクエリ式では、"FieldName" はフィールドの名前を表します)。
((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
(FieldName = @Original_FieldName))
SourceColumnNullMappingフィールドに false を指定すると、SqlCommandBuilder次の WHERE 句が生成されます。
FieldName = @OriginalFieldName
さらに、 @IsNull_FieldName ソース フィールドに null が含まれている場合は 1、含まれていない場合は 0 が格納されます。 このメカニズムにより、SQL Serverでのパフォーマンスの最適化が可能になり、複数のプロバイダー間で動作する一般的なコードが提供されます。
| 製品 | バージョン |
|---|---|
| .NET | Core 1.0, Core 1.1, 6 (package-provided), 7 (package-provided), 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0 (package-provided) |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。