SqlParameter.SourceColumnNullMapping Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se a coluna de origem é anulável. Isto permite SqlCommandBuilder gerar corretamente instruções Update para colunas anuláveis.
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 BooleanValor de Propriedade
true se a coluna de origem for anulável; false Se não for.
Observações
SourceColumnNullMapping é usado pelo SqlCommandBuilder para gerar corretamente comandos de atualização ao lidar com colunas anuláveis. Geralmente, o uso de SourceColumnNullMapping é limitado a desenvolvedores que herdam de SqlCommandBuilder.
DbCommandBuilder usa esta propriedade para determinar se a coluna fonte é nula, e define esta propriedade como true se for nula e false se não for. Quando SqlCommandBuilder está a gerar a sua instrução Update, examina o SourceColumnNullMapping para cada parâmetro. Se a propriedade for true, SqlCommandBuilder gera uma cláusula 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 para o campo for falso, SqlCommandBuilder gera a seguinte cláusula WHERE:
FieldName = @OriginalFieldName
Além disso, @IsNull_FieldName contém 1 se o campo fonte contiver nulo, e 0 se não o fizer. Este mecanismo permite uma otimização de desempenho no SQL Server e proporciona código comum que funciona entre múltiplos fornecedores.