OdbcParameter.SourceColumnNullMapping Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur qui indique si la colonne source accepte la valeur Null. Cela permet à DbCommandBuilder de générer correctement des instructions Update pour les colonnes Nullable.
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 BooleanValeur de propriété
true si la colonne source accepte la valeur Null ; false si ce n’est pas le cas.
Remarques
SourceColumnNullMapping est utilisé par le DbCommandBuilder pour générer correctement des commandes de mise à jour lors du traitement des colonnes nullables. En règle générale, l’utilisation de SourceColumnNullMapping est limitée aux développeurs qui héritent de DbCommandBuilder.
DbCommandBuilder utilise cette propriété pour déterminer si la colonne source peut avoir la valeur Null et définit cette propriété sur true si elle est nullable et false si elle ne l’est pas. Lors DbCommandBuilder de la génération de son instruction Update, il examine le SourceColumnNullMapping pour chaque paramètre. Si la propriété est true, DbCommandBuilder génère une clause WHERE comme dans l’exemple suivant. 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 a la valeur 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 si ce n’est pas le cas. Ce mécanisme permet une optimisation des performances dans SQL Server et fournit du code commun qui fonctionne sur plusieurs fournisseurs.
