DbParameter.SourceColumnNullMapping Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si la columna de origen admite valores NULL. Esto permite a DbCommandBuilder generar correctamente instrucciones Update para las columnas que aceptan valores NULL.
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
Valor de propiedad
true
si la columna de origen acepta valores null; false
en caso contrario.
Comentarios
SourceColumnNullMapping es utilizado por DbCommandBuilder para generar correctamente comandos de actualización al tratar con columnas que aceptan valores NULL. Por lo general, el uso de SourceColumnNullMapping se limita a los desarrolladores que heredan de DbCommandBuilder.
DbCommandBuilder usa esta propiedad para determinar si la columna de origen acepta valores NULL y establece esta propiedad true
en si es que acepta valores NULL y false
si no lo es. Cuando DbCommandBuilder se genera su instrucción Update, examina para SourceColumnNullMapping cada parámetro. Si la propiedad es true
, DbCommandBuilder genera una cláusula WHERE como la siguiente (en esta expresión de consulta, "FieldName" representa el nombre del campo):
((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
(FieldName = @Original_FieldName))
Si SourceColumnNullMapping para el campo es false
, DbCommandBuilder genera la siguiente cláusula WHERE:
FieldName = @OriginalFieldName
Además, @IsNull_FieldName contiene 1 si el campo de origen contiene null y 0 si no lo hace. Este mecanismo permite una optimización del rendimiento en SQL Server y proporciona código común que funciona en varios proveedores.