OleDbParameter.SourceColumnNullMapping Vlastnost

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v8.0.0

Zdroj:

DbParameterHelper.cs

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:
 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 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 má pole hodnotu 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.

Viz také

• Práce s příkazy