SqlParameter.SourceColumnNullMapping Propriété

  • Référence

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paquet:
System.Data.SqlClient v4.8.6

Obtient ou définit une valeur qui indique si la colonne source accepte la valeur Null. Ainsi, SqlCommandBuilder peut générer correctement des instructions Update pour les colonnes qui acceptent la valeur Null.

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

Valeur de propriété

Boolean

true si la colonne source accepte la valeur Null ; false si ce n’est pas le cas.

Remarques

SourceColumnNullMapping est utilisé par pour SqlCommandBuilder 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 SqlCommandBuilder.

DbCommandBuilder utilise cette propriété pour déterminer si la colonne source est nullable et définit cette propriété sur true si elle est nullable et false si elle ne l’est pas. Lors SqlCommandBuilder de la génération de son instruction Update, il examine le SourceColumnNullMapping pour chaque paramètre. Si la propriété est true, SqlCommandBuilder 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 a la valeur false, SqlCommandBuilder 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 un code commun qui fonctionne sur plusieurs fournisseurs.

S’applique à

Voir aussi