Język

RelationalDatabaseFacadeExtensions.SqlQueryRaw<TResult> Metoda

Definicja

Tworzy zapytanie LINQ na podstawie nieprzetworzonego zapytania SQL, które zwraca zestaw wyników typu skalarnego natywnie obsługiwanego przez dostawcę bazy danych.

public static System.Linq.IQueryable<TResult> SqlQueryRaw<TResult>(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object[] parameters);
public static System.Linq.IQueryable<TResult> SqlQueryRaw<TResult>(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object?[] parameters);
static member SqlQueryRaw : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * obj[] -> System.Linq.IQueryable<'Result>
<Extension()>
Public Function SqlQueryRaw(Of TResult) (databaseFacade As DatabaseFacade, sql As String, ParamArray parameters As Object()) As IQueryable(Of TResult)

Parametry typu

TResult

Parametry

databaseFacade
DatabaseFacade

Element DatabaseFacade dla kontekstu.

sql
String

Nieprzetworzone zapytanie SQL.

parameters
Object[]

Wartości, które mają być przypisane do parametrów.

Zwraca

IQueryable<TResult>

Element IQueryable<T> reprezentujący nieprzetworzone zapytanie SQL.

Uwagi

Aby użyć tej metody z typem zwracanym, który nie jest natywnie obsługiwany przez dostawcę bazy danych, użyj DefaultTypeMapping<TScalar>(Action<TypeMappingConfigurationBuilder<TScalar>>) metody .

Zwrócony IQueryable<T> element może składać się za pomocą LINQ w celu tworzenia bardziej złożonych zapytań.

Pamiętaj, że ta metoda nie uruchamia transakcji. Aby użyć tej metody z transakcją, najpierw wywołaj BeginTransaction(DatabaseFacade, IsolationLevel) lub UseTransaction.

Podobnie jak w przypadku dowolnego interfejsu API akceptującego język SQL, ważne jest, aby sparametryzować dane wejściowe dowolnego użytkownika w celu ochrony przed atakiem polegającym na wstrzyknięciu kodu SQL. W ciągu zapytania SQL można uwzględnić symbole zastępcze parametrów, a następnie podać wartości parametrów jako dodatkowe argumenty. Wszystkie wartości parametrów, które podajesz, zostaną automatycznie przekonwertowane na parametr DbParameter.

Jednak nigdy nie należy przekazywać połączonych lub interpolowanych ciągów ($"") z niewalidowanymi wartościami podanymi przez użytkownika w tej metodzie. Może to spowodować uwidocznienie aplikacji ataków polegających na wstrzyknięciu kodu SQL. Aby użyć składni ciągów interpolowanych, rozważ użycie metody SqlQuery<TResult>(DatabaseFacade, FormattableString) do utworzenia parametrów.

Aby uzyskać więcej informacji i przykładów, zobacz Wykonywanie nieprzetworzonych poleceń SQL za pomocą programu EF Core .

Dotyczy