DbParameter.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ść wskazującą, czy kolumna źródłowa ma wartość null. Dzięki temu można DbCommandBuilder poprawnie wygenerować instrukcje aktualizacji 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, setPublic MustOverride Property SourceColumnNullMapping As BooleanWartość 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 dziedziczących z DbCommandBuilderprogramu .
DbCommandBuilder używa tej właściwości, aby określić, czy kolumna źródłowa jest dopuszczana do wartości 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 pole ma falsewartość , 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.
