DbParameter.SourceColumnNullMapping Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se a coluna de origem é anulável. Isso permite DbCommandBuilder gerar corretamente instruções update para colunas anuláveis.
public:
abstract property bool SourceColumnNullMapping { bool get(); void set(bool value); };public abstract bool SourceColumnNullMapping { get; set; }member this.SourceColumnNullMapping : bool with get, setPublic MustOverride Property SourceColumnNullMapping As BooleanValor da propriedade
true se a coluna de origem for anulável; false se não for.
Comentários
SourceColumnNullMapping é usado pela geração correta de DbCommandBuilder comandos de atualização ao lidar com colunas anuláveis. Geralmente, o uso de SourceColumnNullMapping é limitado a desenvolvedores herdados de DbCommandBuilder.
DbCommandBuilder usa essa propriedade para determinar se a coluna de origem é anulável e define essa propriedade como true se ela for anulável e false se não for. Quando DbCommandBuilder gera sua instrução Update, ela examina o SourceColumnNullMapping parâmetro para cada parâmetro. Se a propriedade for true, DbCommandBuilder gerará cláusulas WHERE como a seguinte (nesta expressão de consulta, "FieldName" representa o nome do campo):
((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
(FieldName = @Original_FieldName))
Se SourceColumnNullMapping for para o campo false, DbCommandBuilder gerará a seguinte cláusula WHERE:
FieldName = @OriginalFieldName
Além disso, @IsNull_FieldName contém 1 se o campo de origem contiver nulo e 0 se não o fizer. Esse mecanismo permite uma otimização de desempenho em SQL Server e fornece um código comum que funciona em vários provedores.