SqlParameter.SourceColumnNullMapping Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur nilai yang menunjukkan apakah kolom sumber dapat diubah ke null. Ini memungkinkan SqlCommandBuilder untuk membuat pernyataan Pembaruan dengan benar untuk kolom yang dapat diubah ke null.
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
Nilai Properti
true
jika kolom sumber dapat diubah ke null; false
jika tidak.
Keterangan
SourceColumnNullMapping digunakan oleh SqlCommandBuilder untuk menghasilkan perintah pembaruan dengan benar saat berhadapan dengan kolom yang dapat diubah ke null. Umumnya, penggunaan SourceColumnNullMapping terbatas pada pengembang yang mewarisi dari SqlCommandBuilder.
DbCommandBuilder menggunakan properti ini untuk menentukan apakah kolom sumber dapat diubah ke null, dan mengatur properti ini ke true
jika dapat diubah ke null, dan false
jika tidak. Saat SqlCommandBuilder menghasilkan pernyataan Pembaruan, ia memeriksa SourceColumnNullMapping untuk setiap parameter. Jika properti adalah true
, SqlCommandBuilder menghasilkan klausa WHERE seperti berikut ini (dalam ekspresi kueri ini, "FieldName" mewakili nama bidang):
((@IsNull_FieldName = 1 AND FieldName IS NULL) OR
(FieldName = @Original_FieldName))
Jika SourceColumnNullMapping untuk bidang salah, SqlCommandBuilder menghasilkan klausul WHERE berikut:
FieldName = @OriginalFieldName
Selain itu, @IsNull_FieldName berisi 1 jika bidang sumber berisi null, dan 0 jika tidak. Mekanisme ini memungkinkan pengoptimalan performa dalam SQL Server, dan menyediakan kode umum yang berfungsi di beberapa penyedia.