DbParameter.SourceColumnNullMapping Proprietà

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbParameter.cs

Ottiene o imposta un valore che indica se la colonna di origine ammette valori Null. Questo consente a DbCommandBuilder di generare correttamente istruzioni Update per le colonne nullable.

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

Valore della proprietà

Boolean

true se la colonna di origine ammette valori Null; in caso contrario, false.

Commenti

SourceColumnNullMapping viene usato da DbCommandBuilder per generare correttamente i comandi di aggiornamento quando si gestiscono colonne nullable. In genere, l'uso di SourceColumnNullMapping è limitato agli sviluppatori che ereditano da DbCommandBuilder.

DbCommandBuilder usa questa proprietà per determinare se la colonna di origine è nullable e imposta questa proprietà su true se è nullable e false in caso contrario. Quando DbCommandBuilder genera l'istruzione Update, esamina l'oggetto SourceColumnNullMapping per ogni parametro. Se la proprietà è true, DbCommandBuilder genera clausole WHERE come la seguente (in questa espressione di query "FieldName" rappresenta il nome del campo):

((@IsNull_FieldName = 1 AND FieldName IS NULL) OR   
  (FieldName = @Original_FieldName))  

Se SourceColumnNullMapping per il campo è false, DbCommandBuilder genera la clausola WHERE seguente:

FieldName = @OriginalFieldName  

Contiene inoltre @IsNull_FieldName 1 se il campo di origine contiene null e 0 in caso contrario. Questo meccanismo consente un'ottimizzazione delle prestazioni in SQL Server e fornisce codice comune che funziona in più provider.

Vedi anche

• Panoramica di ADO.NET