SqlParameter.SourceColumnNullMapping Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mengatur atau mendapatkan nilai yang menunjukkan apakah kolom sumber dapat diubah ke null. Ini memungkinkan SqlCommandBuilder untuk menghasilkan 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

Boolean

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. Ketika 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 adalah false, 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.