Udostępnij za pośrednictwem

SqlParameter.SourceColumnNullMapping Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.SqlClient
Zestaw:
System.Data.SqlClient.dll
Zestaw:
System.Data.dll
Zestawy:
netstandard.dll, System.Data.SqlClient.dll
Pakiet:
System.Data.SqlClient v4.8.6

Pobiera lub ustawia wartość wskazującą, czy kolumna źródłowa ma wartość null. SqlCommandBuilder Umożliwia to poprawne generowanie instrukcji Update 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

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 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, 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 SqlCommandBuilder generowania instrukcji Update sprawdza wartość dla każdego parametru SourceColumnNullMapping . Jeśli właściwość to true, 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 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.

Dotyczy

Zobacz też