OleDbParameter.SourceColumnNullMapping Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość, która wskazuje, czy kolumna źródłowa jest dopuszczana do wartości null. Dzięki temu można DbCommandBuilder poprawnie wygenerować instrukcje aktualizacji dla kolumn dopuszczanych do wartości 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
Wartość właściwości
true
jeśli kolumna źródłowa ma wartość null; false
jeśli tak nie jest.
Uwagi
SourceColumnNullMapping polecenie jest używane przez element 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 do określenia, czy kolumna źródłowa ma wartość null, i ustawia tę właściwość na true
wartość , jeśli jest dopuszczana wartość null, a false
jeśli nie. Podczas DbCommandBuilder generowania instrukcji Update sprawdza wartość dla każdego parametru SourceColumnNullMapping . Jeśli właściwość ma true
wartość , 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 pole ma wartość false, DbCommandBuilder generuje następującą klauzulę WHERE:
FieldName = @OriginalFieldName
Ponadto element 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.