SqlParameter.SourceColumnNullMapping Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Quellspalte nullwertebar ist. Dadurch können SqlCommandBuilder Aktualisierungsanweisungen für nullwerte Spalten ordnungsgemäß generiert werden.
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 BooleanEigenschaftswert
true wenn die Quellspalte nullwertebar ist; false wenn nicht.
Hinweise
SourceColumnNullMapping wird verwendet, SqlCommandBuilder um Aktualisierungsbefehle beim Umgang mit nullfähigen Spalten ordnungsgemäß zu generieren. Im Allgemeinen ist die Verwendung auf SourceColumnNullMapping Entwickler beschränkt, die von SqlCommandBuilder.
DbCommandBuilder verwendet diese Eigenschaft, um zu bestimmen, ob die Quellspalte nullwertebar ist, und legt diese Eigenschaft fest, true ob sie nullwertebar ist und false wenn dies nicht der Fall ist. Beim SqlCommandBuilder Generieren der Update-Anweisung überprüft sie die SourceColumnNullMapping einzelnen Parameter. Wenn die Eigenschaft lautet true, SqlCommandBuilder wird eine WHERE-Klausel wie die folgende generiert (in diesem Abfrageausdruck stellt "FieldName" den Namen des Felds dar):
((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
(FieldName = @Original_FieldName))
Wenn SourceColumnNullMapping für das Feld "false" angegeben ist, SqlCommandBuilder wird die folgende WHERE-Klausel generiert:
FieldName = @OriginalFieldName
Enthält außerdem 1, @IsNull_FieldName wenn das Quellfeld null und 0 enthält, wenn dies nicht der Fall ist. Dieser Mechanismus ermöglicht eine Leistungsoptimierung in SQL Server und stellt allgemeinen Code bereit, der für mehrere Anbieter geeignet ist.