SqlParameter.SourceColumnNullMapping 屬性

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

設定或取得值，這個值表示來源資料行是否可為 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, set

Public Overrides Property SourceColumnNullMapping As Boolean

屬性值

Boolean

如果來源資料行可為 Null，則為 true；否則為 false。

備註

SourceColumnNullMapping 用於 SqlCommandBuilder 在處理可為 Null 的資料行時正確產生更新命令。 一般而言，的使用 SourceColumnNullMapping 僅限於繼承自 的 SqlCommandBuilder 開發人員。

DbCommandBuilder 會使用這個屬性來判斷來源資料行是否可為 Null，如果這個屬性 true 為可為 Null，則 false 設定為 ，如果不是，則為 。 產生 Update 語句時 SqlCommandBuilder ，它會檢查 SourceColumnNullMapping 每個參數的 。 如果 屬性為 true ， SqlCommandBuilder 則在此查詢運算式中會產生類似下列 (的 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中的效能優化，並提供跨多個提供者運作的常見程式碼。