SqlParameter.SourceColumnNullMapping Properti

  • Referensi

Definisi

Ruang nama:
System.Data.SqlClient
Rakitan:
System.Data.SqlClient.dll
Rakitan:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

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

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. 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.

Berlaku untuk

Lihat juga