DbParameter.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 DbCommandBuilder správně generovat příkazy Update pro sloupce s možnou hodnotou null.
public:
abstract property bool SourceColumnNullMapping { bool get(); void set(bool value); };public abstract bool SourceColumnNullMapping { get; set; }member this.SourceColumnNullMapping : bool with get, setPublic MustOverride Property SourceColumnNullMapping As BooleanHodnota vlastnosti
true Pokud zdrojový sloupec je nullable; false pokud není.
Poznámky
SourceColumnNullMapping se používá ke správnému DbCommandBuilder 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 DbCommandBuilder.
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 DbCommandBuilder generování příkazu Update zkontroluje SourceColumnNullMapping pro každý parametr hodnotu . Pokud je truevlastnost , DbCommandBuilder 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 je falsepro pole , DbCommandBuilder 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.
