SqlParameter.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.
Ustawia lub pobiera wartość, która wskazuje, czy kolumna źródłowa jest dopuszczana do wartości null. Dzięki temu można SqlCommandBuilder 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, setPublic Overrides 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 SqlCommandBuilder 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 SqlCommandBuilderprogramu .
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 SqlCommandBuilder generowania instrukcji Update sprawdza wartość dla każdego parametru SourceColumnNullMapping . Jeśli właściwość ma truewartość , SqlCommandBuilder 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, SqlCommandBuilder 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.