DbParameter.SourceColumnNullMapping Propriedade

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DbParameter.cs

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:
 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 da propriedade

Boolean

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. Geralmente, o uso de SourceColumnNullMapping é limitado aos desenvolvedores que herdam 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 está gerando sua instrução Update, ela examina o SourceColumnNullMapping para cada parâmetro. Se a propriedade for true, DbCommandBuilder gerará 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 for para o campo for 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 código comum que funciona em vários provedores.

Confira também

• Visão geral do ADO.NET