OleDbParameter.SourceColumnNullMapping Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.OleDb
Assembly:
System.Data.OleDb.dll
Assembly:
System.Data.dll

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:
 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

Eigenschaftswert

Boolean

true, wenn die Quellspalte NULL-Werte zulässt, andernfalls false.

Hinweise

SourceColumnNullMapping wird von den DbCommandBuilder Befehlen zum ordnungsgemäßen Generieren von Updatebefehlen beim Umgang mit nullablen Spalten verwendet. Im Allgemeinen ist die Verwendung SourceColumnNullMapping auf Entwickler beschränkt, die von DbCommandBuildererben.

DbCommandBuilder verwendet diese Eigenschaft, um zu bestimmen, ob die Quellspalte nullfähig ist, und legt diese Eigenschaft true fest, wenn sie nullfähig ist und false wenn es nicht ist. Wenn DbCommandBuilder die Update-Anweisung generiert wird, wird dies SourceColumnNullMapping für jeden Parameter untersucht. Wenn die Eigenschaft trueist , DbCommandBuilder generiert eine WHERE-Klausel wie folgt (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 falsch ist, DbCommandBuilder generiert die folgende WHERE-Klausel:

FieldName = @OriginalFieldName

Enthält außerdem @IsNull_FieldName 1, wenn das Quellfeld null enthält, und 0, wenn er nicht. Dieser Mechanismus ermöglicht eine Leistungsoptimierung in SQL Server und bietet gängigen Code, der in mehreren Anbietern funktioniert.

Gilt für:

Siehe auch