DbParameter.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.
Ruft einen Wert ab, der angibt, ob die Quellspalte NULL-Werte zulässt, oder legt diesen fest. Dadurch kann DbCommandBuilder ordnungsgemäß Update-Anweisungen für Spalten generieren, die NULL-Werte zulassen.
public:
abstract property bool SourceColumnNullMapping { bool get(); void set(bool value); };
public abstract bool SourceColumnNullMapping { get; set; }
member this.SourceColumnNullMapping : bool with get, set
Public MustOverride Property SourceColumnNullMapping As Boolean
Eigenschaftswert
true
, wenn die Quellspalte NULL-Werte zulässt, andernfalls false
.
Hinweise
SourceColumnNullMapping wird verwendet, um DbCommandBuilder Aktualisierungsbefehle beim Umgang mit nullablen Spalten ordnungsgemäß zu generieren. Im Allgemeinen ist die Verwendung SourceColumnNullMapping auf Entwickler beschränkt, die von DbCommandBuilder.
DbCommandBuilder verwendet diese Eigenschaft, um zu ermitteln, ob die Quellspalte nullfähig ist, und legt diese Eigenschaft fest true
, wenn sie nullfähig ist und false
wenn dies nicht der Fall ist. Wenn DbCommandBuilder die Update-Anweisung generiert wird, wird dies SourceColumnNullMapping für jeden Parameter untersucht. Wenn die Eigenschaft lautet true
, DbCommandBuilder generiert eine WHERE-Klausel wie folgende (in diesem Abfrageausdruck stellt "FieldName" den Namen des Felds dar):
((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
(FieldName = @Original_FieldName))
Wenn SourceColumnNullMapping das Feld lautet false
, DbCommandBuilder generiert die folgende WHERE-Klausel:
FieldName = @OriginalFieldName
Enthält außerdem @IsNull_FieldName 1, wenn das Quellfeld Null enthält, und 0, wenn es nicht der Fall ist. Dieser Mechanismus ermöglicht eine Leistungsoptimierung in SQL Server und bietet allgemeinen Code, der über mehrere Anbieter hinweg funktioniert.