RelationalDatabaseFacadeExtensions.ExecuteSqlCommand 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| ExecuteSqlCommand(DatabaseFacade, FormattableString) |
已淘汰.
對資料庫執行給定的 SQL,並回傳受影響的列數。 請注意,此方法不會啟動交易。 若要使用此方法處理交易,首先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 請注意,此方法不使用當前 ExecutionStrategy 值,因為 SQL 可能不是冪등元,且不在交易中執行。 執行策略可以明確使用,確保如果 SQL 不是冪等元,也要使用交易。
和任何接受 SQL 的 API 一樣,必須對使用者輸入進行參數化,以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符,然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter - |
| ExecuteSqlCommand(DatabaseFacade, RawSqlString, IEnumerable<Object>) |
已淘汰.
對資料庫執行給定的 SQL,並回傳受影響的列數。 請注意,此方法不會啟動交易。 若要使用此方法處理交易,首先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 請注意,此方法不使用當前 ExecutionStrategy 值,因為 SQL 可能不是冪등元,且不在交易中執行。 執行策略可以明確使用,確保如果 SQL 不是冪等元,也要使用交易。 和任何接受 SQL 的 API 一樣,必須對使用者輸入進行參數化,以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符,然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter。 你也可以考慮使用 ExecuteSqlInterpolated,利用插值字串語法來建立參數。 |
| ExecuteSqlCommand(DatabaseFacade, RawSqlString, Object[]) |
已淘汰.
對資料庫執行給定的 SQL,並回傳受影響的列數。 請注意,此方法不會啟動交易。 若要使用此方法處理交易,首先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 請注意,此方法不使用當前 ExecutionStrategy 值,因為 SQL 可能不是冪등元,且不在交易中執行。 執行策略可以明確使用,確保如果 SQL 不是冪等元,也要使用交易。
和任何接受 SQL 的 API 一樣,必須對使用者輸入進行參數化,以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符,然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter - |
| ExecuteSqlCommand(DatabaseFacade, String, Object[]) |
ExecuteSqlCommand(DatabaseFacade, FormattableString)
警告
For the execution of SQL queries using plain strings, use ExecuteSqlRaw instead. For the execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolated instead.
對資料庫執行給定的 SQL,並回傳受影響的列數。
請注意,此方法不會啟動交易。 若要使用此方法處理交易,首先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。
請注意,此方法不使用當前 ExecutionStrategy 值,因為 SQL 可能不是冪등元,且不在交易中執行。 執行策略可以明確使用,確保如果 SQL 不是冪等元,也要使用交易。
和任何接受 SQL 的 API 一樣,必須對使用者輸入進行參數化,以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符,然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter - context.Database.ExecuteSqlCommand($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")。
public static int ExecuteSqlCommand(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql);
[System.Obsolete("For the execution of SQL queries using plain strings, use ExecuteSqlRaw instead. For the execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolated instead.")]
public static int ExecuteSqlCommand(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql);
static member ExecuteSqlCommand : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString -> int
[<System.Obsolete("For the execution of SQL queries using plain strings, use ExecuteSqlRaw instead. For the execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolated instead.")>]
static member ExecuteSqlCommand : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString -> int
<Extension()>
Public Function ExecuteSqlCommand (databaseFacade As DatabaseFacade, sql As FormattableString) As Integer
參數
- databaseFacade
- DatabaseFacade
這是 DatabaseFacade 給你背景的。
插值字串代表帶有參數的 SQL 查詢。
傳回
受影響的行數。
- 屬性
適用於
ExecuteSqlCommand(DatabaseFacade, RawSqlString, IEnumerable<Object>)
警告
For the execution of SQL queries using plain strings, use ExecuteSqlRaw instead. For the execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolated instead.
對資料庫執行給定的 SQL,並回傳受影響的列數。
請注意,此方法不會啟動交易。 若要使用此方法處理交易,首先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。
請注意,此方法不使用當前 ExecutionStrategy 值,因為 SQL 可能不是冪등元,且不在交易中執行。 執行策略可以明確使用,確保如果 SQL 不是冪等元,也要使用交易。
和任何接受 SQL 的 API 一樣,必須對使用者輸入進行參數化,以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符,然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter。 你也可以考慮使用 ExecuteSqlInterpolated,利用插值字串語法來建立參數。
public static int ExecuteSqlCommand(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, System.Collections.Generic.IEnumerable<object> parameters);
[System.Obsolete("For the execution of SQL queries using plain strings, use ExecuteSqlRaw instead. For the execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolated instead.")]
public static int ExecuteSqlCommand(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, System.Collections.Generic.IEnumerable<object> parameters);
static member ExecuteSqlCommand : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * seq<obj> -> int
[<System.Obsolete("For the execution of SQL queries using plain strings, use ExecuteSqlRaw instead. For the execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolated instead.")>]
static member ExecuteSqlCommand : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * seq<obj> -> int
<Extension()>
Public Function ExecuteSqlCommand (databaseFacade As DatabaseFacade, sql As RawSqlString, parameters As IEnumerable(Of Object)) As Integer
參數
- databaseFacade
- DatabaseFacade
這是 DatabaseFacade 給你背景的。
- sql
- RawSqlString
執行的 SQL 是
- parameters
- IEnumerable<Object>
這些參數可以用在 SQL 上。
傳回
受影響的行數。
- 屬性
適用於
ExecuteSqlCommand(DatabaseFacade, RawSqlString, Object[])
警告
For the execution of SQL queries using plain strings, use ExecuteSqlRaw instead. For the execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolated instead.
對資料庫執行給定的 SQL,並回傳受影響的列數。
請注意,此方法不會啟動交易。 若要使用此方法處理交易,首先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。
請注意,此方法不使用當前 ExecutionStrategy 值,因為 SQL 可能不是冪등元,且不在交易中執行。 執行策略可以明確使用,確保如果 SQL 不是冪等元,也要使用交易。
和任何接受 SQL 的 API 一樣,必須對使用者輸入進行參數化,以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符,然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter - context.Database.ExecuteSqlCommand("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)。
你也可以考慮使用 ExecuteSqlInterpolated,利用插值字串語法來建立參數。
public static int ExecuteSqlCommand(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, params object[] parameters);
[System.Obsolete("For the execution of SQL queries using plain strings, use ExecuteSqlRaw instead. For the execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolated instead.")]
public static int ExecuteSqlCommand(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, params object[] parameters);
static member ExecuteSqlCommand : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * obj[] -> int
[<System.Obsolete("For the execution of SQL queries using plain strings, use ExecuteSqlRaw instead. For the execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolated instead.")>]
static member ExecuteSqlCommand : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * obj[] -> int
<Extension()>
Public Function ExecuteSqlCommand (databaseFacade As DatabaseFacade, sql As RawSqlString, ParamArray parameters As Object()) As Integer
參數
- databaseFacade
- DatabaseFacade
這是 DatabaseFacade 給你背景的。
- sql
- RawSqlString
執行的 SQL 是
- parameters
- Object[]
這些參數可以用在 SQL 上。
傳回
受影響的行數。
- 屬性
適用於
ExecuteSqlCommand(DatabaseFacade, String, Object[])
public static int ExecuteSqlCommand(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object[] parameters);
static member ExecuteSqlCommand : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * obj[] -> int
<Extension()>
Public Function ExecuteSqlCommand (databaseFacade As DatabaseFacade, sql As String, ParamArray parameters As Object()) As Integer
參數
- databaseFacade
- DatabaseFacade
- sql
- String
- parameters
- Object[]