OdbcParameter.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 permite valor nulo. Isso permite que DbCommandBuilder gere corretamente instruções Update para colunas que permitem valor nulo.
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
Valor da propriedade
true
se a coluna de origem for nula; caso contrário, false
.
Comentários
SourceColumnNullMapping é usado pelo DbCommandBuilder para gerar corretamente comandos de atualização ao lidar com colunas anuláveis. Em geral, 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 true
como se ela for anulável e false
se não for. Quando DbCommandBuilder está gerando sua instrução Update, ele examina o SourceColumnNullMapping para cada parâmetro. Se a propriedade for true
, DbCommandBuilder gerará cláusulas WHERE como o exemplo a seguir. 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 false, DbCommandBuilder gerará a seguinte cláusula WHERE:
FieldName = @OriginalFieldName
Além disso, @IsNull_FieldName conterá 1 se o campo de origem contiver nulo e 0 se não contiver. Esse mecanismo permite uma otimização de desempenho em SQL Server e fornece código comum que funciona em vários provedores.