SqlParameter.SourceColumnNullMapping Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se la colonna di origine è nullable. Questo consente a SqlCommandBuilder di generare correttamente istruzioni Update per le colonne nullable.
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 BooleanValore della proprietà
true se la colonna di origine ammette valori Null; in caso contrario, false.
Commenti
SourceColumnNullMapping viene usato dall'oggetto SqlCommandBuilder per generare correttamente i comandi di aggiornamento quando si gestiscono colonne nullable. In genere, l'uso di SourceColumnNullMapping è limitato agli sviluppatori che ereditano da SqlCommandBuilder.
DbCommandBuilder usa questa proprietà per determinare se la colonna di origine è nullable e imposta questa proprietà su true se è nullable e false se non è. Quando SqlCommandBuilder genera l'istruzione Update, esamina l'oggetto SourceColumnNullMapping per ogni parametro. Se la proprietà è true, SqlCommandBuilder genera clausole WHERE come le seguenti (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, SqlCommandBuilder genera la clausola WHERE seguente:
FieldName = @OriginalFieldName
Contiene inoltre @IsNull_FieldName 1 se il campo di origine contiene null e 0 se non lo fa. Questo meccanismo consente un'ottimizzazione delle prestazioni in SQL Server e fornisce codice comune che funziona in più provider.