SqlParameter.SourceColumnNullMapping Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu, která označuje, zda zdrojový sloupec je nullable. To umožňuje SqlCommandBuilder správně generovat příkazy Update pro sloupce s možnou hodnotou null.
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 BooleanHodnota vlastnosti
true Pokud zdrojový sloupec je nullable; false pokud není.
Poznámky
SourceColumnNullMapping se používá ke správnému SqlCommandBuilder generování aktualizačních příkazů při práci se sloupci s možnou hodnotou null. Obecně platí, že použití SourceColumnNullMapping je omezené na vývojáře, kteří dědí z SqlCommandBuilder.
DbCommandBuilder používá tuto vlastnost k určení, zda zdrojový sloupec může být null, a nastaví tuto vlastnost na true hodnotu , pokud je nullable, a false pokud není. Při SqlCommandBuilder generování příkazu Update zkontroluje SourceColumnNullMapping pro každý parametr hodnotu . Pokud je truevlastnost , SqlCommandBuilder vygeneruje klauzule WHERE podobné následující (v tomto výrazu dotazu "FieldName" představuje název pole):
((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
(FieldName = @Original_FieldName))
Pokud SourceColumnNullMapping má pole hodnotu false, SqlCommandBuilder vygeneruje následující klauzuli WHERE:
FieldName = @OriginalFieldName
Kromě toho obsahuje hodnotu 1, @IsNull_FieldName pokud zdrojové pole obsahuje hodnotu null, a 0, pokud ne. Tento mechanismus umožňuje optimalizaci výkonu v SQL Server a poskytuje společný kód, který funguje napříč několika poskytovateli.
