OleDbParameter.SourceColumnNullMapping Vlastnost

Definice

Obor názvů:
System.Data.OleDb
Sestavení:
System.Data.dll

Získá nebo nastaví hodnotu, která označuje, zda zdrojový sloupec má hodnotu null. To umožňuje DbCommandBuilder 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, set
Public Overrides Property SourceColumnNullMapping As Boolean

Hodnota vlastnosti

Boolean

true pokud zdrojový sloupec má hodnotu null; false pokud tomu tak není.

Poznámky

SourceColumnNullMapping slouží k správnému generování aktualizačních příkazů při práci se sloupci s možnou DbCommandBuilder hodnotou null. Obecně platí, že použití SourceColumnNullMapping je omezeno na vývojáře dědící z DbCommandBuilder.

DbCommandBuilder používá tuto vlastnost k určení, zda zdrojový sloupec má hodnotu null, a nastaví tuto vlastnost na true , zda je nullable, a false pokud není. Když DbCommandBuilder generujete jeho příkaz Update, zkontroluje SourceColumnNullMapping pro každý parametr. Pokud je truevlastnost , DbCommandBuilder vygeneruje klauzule WHERE jako 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 pole false, 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.

Platí pro

Viz také