RelationalDatabaseFacadeExtensions.ExecuteSql Metode

Definisi

Ruang nama:

Microsoft.EntityFrameworkCore

Rakitan:

Microsoft.EntityFrameworkCore.Relational.dll

Paket:

Microsoft.EntityFrameworkCore.Relational v8.0.0

Menjalankan SQL yang diberikan terhadap database dan mengembalikan jumlah baris yang terpengaruh.

public static int ExecuteSql (this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql);

static member ExecuteSql : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString -> int

<Extension()>
Public Function ExecuteSql (databaseFacade As DatabaseFacade, sql As FormattableString) As Integer

Parameter

databaseFacade

DatabaseFacade

DatabaseFacade untuk konteksnya.

sql

FormattableString

String terinterpolasi yang mewakili kueri SQL dengan parameter.

Mengembalikan

Int32

Jumlah baris yang terpengaruh.

Keterangan

Perhatikan bahwa metode ini tidak memulai transaksi. Untuk menggunakan metode ini dengan transaksi, pertama-tama panggil BeginTransaction(DatabaseFacade, IsolationLevel) atau UseTransaction.

Perhatikan bahwa saat ini ExecutionStrategy tidak digunakan oleh metode ini karena SQL mungkin tidak idempotensi dan tidak berjalan dalam transaksi. Dapat ExecutionStrategy digunakan secara eksplisit, memastikan juga untuk menggunakan transaksi jika SQL tidak idempotensi.

Seperti halnya API apa pun yang menerima SQL, penting untuk membuat parameter input pengguna apa pun untuk melindungi dari serangan injeksi SQL. Anda dapat menyertakan tempat penampung parameter dalam string kueri SQL lalu menyediakan nilai parameter sebagai argumen tambahan. Nilai parameter apa pun yang Anda berikan akan secara otomatis dikonversi ke DbParameter.

Lihat Menjalankan perintah SQL mentah dengan EF Core untuk informasi dan contoh selengkapnya.