DbParameter.SourceColumnNullMapping Propriété

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.dll

Obtient ou définit une valeur qui indique si la colonne source est nullable. Cela permet DbCommandBuilder de générer correctement des instructions Update pour les colonnes nullables.

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

Valeur de propriété

Boolean

true si la colonne source est nullable ; false si ce n’est pas le cas.

Remarques

SourceColumnNullMapping est utilisé par les DbCommandBuilder commandes de mise à jour pour générer correctement des commandes de mise à jour lors du traitement des colonnes nullables. En règle générale, l’utilisation est SourceColumnNullMapping limitée aux développeurs qui héritent de DbCommandBuilder.

DbCommandBuilder utilise cette propriété pour déterminer si la colonne source est nullable et définit cette propriété true si elle est nullable, et false si ce n’est pas le cas. Quand DbCommandBuilder elle génère son instruction Update, elle examine la SourceColumnNullMapping valeur de chaque paramètre. Si la propriété est true, DbCommandBuilder génère une clause WHERE comme suit (dans cette expression de requête, « FieldName » représente le nom du champ) :

((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
  (FieldName = @Original_FieldName))

Si SourceColumnNullMapping pour le champ est false, DbCommandBuilder génère la clause WHERE suivante :

FieldName = @OriginalFieldName

En outre, @IsNull_FieldName contient 1 si le champ source contient null et 0 s’il ne le fait pas. Ce mécanisme permet une optimisation des performances dans SQL Server et fournit du code commun qui fonctionne sur plusieurs fournisseurs.

Voir aussi

• Vue d'ensemble d’ADO.NET