DbParameter.SourceColumnNullMapping Właściwość

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Źródło:

DbParameter.cs

Pobiera lub ustawia wartość wskazującą, czy kolumna źródłowa ma wartość null. DbCommandBuilder Umożliwia to poprawne generowanie instrukcji Update dla kolumn dopuszczanych do wartości null.

public:
 abstract property bool SourceColumnNullMapping { bool get(); void set(bool value); };

public abstract bool SourceColumnNullMapping { get; set; }

member this.SourceColumnNullMapping : bool with get, set

Public MustOverride Property SourceColumnNullMapping As Boolean

Wartość właściwości

Boolean

true jeśli kolumna źródłowa ma wartość null; false jeśli tak nie jest.

Uwagi

SourceColumnNullMapping jest używany przez polecenie do poprawnego DbCommandBuilder generowania poleceń aktualizacji podczas pracy z kolumnami dopuszczanymi do wartości null. Ogólnie rzecz biorąc, korzystanie z programu SourceColumnNullMapping jest ograniczone do deweloperów dziedziczyjących z DbCommandBuilderprogramu .

DbCommandBuilder używa tej właściwości, aby określić, czy kolumna źródłowa ma wartość null, i ustawia tę właściwość na true wartość null, a false jeśli nie. Podczas DbCommandBuilder generowania instrukcji Update sprawdza wartość dla każdego parametru SourceColumnNullMapping . Jeśli właściwość to true, DbCommandBuilder generuje klauzule WHERE, takie jak następujące (w tym wyrażeniu zapytania "FieldName" reprezentuje nazwę pola):

((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
  (FieldName = @Original_FieldName))

Jeśli SourceColumnNullMapping dla pola to false, DbCommandBuilder generuje następującą klauzulę WHERE:

FieldName = @OriginalFieldName

Ponadto zawiera wartość 1, @IsNull_FieldName jeśli pole źródłowe zawiera wartość null i 0, jeśli nie. Ten mechanizm umożliwia optymalizację wydajności w SQL Server i zapewnia wspólny kod, który działa u wielu dostawców.

Zobacz też

• Omówienie ADO.NET