RelationalDatabaseFacadeExtensions Classe

Définition

Méthodes d’extension pour le DatabaseFacade retourné par Database qui ne peuvent être utilisées qu’avec des fournisseurs de base de données relationnelle.

public static class RelationalDatabaseFacadeExtensions
type RelationalDatabaseFacadeExtensions = class
Public Module RelationalDatabaseFacadeExtensions
Héritage
RelationalDatabaseFacadeExtensions

Méthodes

BeginTransaction(DatabaseFacade, IsolationLevel)

Démarre une nouvelle transaction avec un donné IsolationLevel.

BeginTransactionAsync(DatabaseFacade, IsolationLevel, CancellationToken)

Démarre de façon asynchrone une nouvelle transaction avec un donné IsolationLevel.

CloseConnection(DatabaseFacade)

Ferme le sous-jacent DbConnection.

CloseConnectionAsync(DatabaseFacade)

Ferme le sous-jacent DbConnection.

ExecuteSql(DatabaseFacade, FormattableString)

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

ExecuteSqlAsync(DatabaseFacade, FormattableString, CancellationToken)

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

ExecuteSqlCommand(DatabaseFacade, FormattableString)
Obsolète.

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

Notez que cette méthode ne démarre pas une transaction. Pour utiliser cette méthode avec une transaction, appelez BeginTransaction(DatabaseFacade, IsolationLevel) d’abord ou UseTransaction(DatabaseFacade, DbTransaction).

Notez que le actuel ExecutionStrategy n’est pas utilisé par cette méthode, car le sql n’est peut-être pas idempotent et ne s’exécute pas dans une transaction. Une stratégie d’exécution peut être utilisée explicitement, en veillant à utiliser également une transaction si le code SQL n’est pas idempotent.

Comme pour toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection de code SQL. Vous pouvez inclure des espaces réservés de paramètres dans la chaîne de requête SQL, puis fournir des valeurs de paramètre en tant qu’arguments supplémentaires. Toutes les valeurs de paramètre que vous fournissez sont automatiquement converties en DbParameter - context.Database.ExecuteSqlCommand($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").

ExecuteSqlCommand(DatabaseFacade, RawSqlString, IEnumerable<Object>)
Obsolète.

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

Notez que cette méthode ne démarre pas une transaction. Pour utiliser cette méthode avec une transaction, appelez BeginTransaction(DatabaseFacade, IsolationLevel) d’abord ou UseTransaction(DatabaseFacade, DbTransaction).

Notez que le actuel ExecutionStrategy n’est pas utilisé par cette méthode, car le sql n’est peut-être pas idempotent et ne s’exécute pas dans une transaction. Une stratégie d’exécution peut être utilisée explicitement, en veillant à utiliser également une transaction si le code SQL n’est pas idempotent.

Comme pour toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection de code SQL. Vous pouvez inclure des espaces réservés de paramètres dans la chaîne de requête SQL, puis fournir des valeurs de paramètre en tant qu’arguments supplémentaires. Toutes les valeurs de paramètre que vous fournissez sont automatiquement converties en DbParameter. Vous pouvez également envisager d’utiliser ExecuteSqlInterpolated pour utiliser la syntaxe de chaîne interpolée pour créer des paramètres.

ExecuteSqlCommand(DatabaseFacade, RawSqlString, Object[])
Obsolète.

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

Notez que cette méthode ne démarre pas une transaction. Pour utiliser cette méthode avec une transaction, appelez BeginTransaction(DatabaseFacade, IsolationLevel) d’abord ou UseTransaction(DatabaseFacade, DbTransaction).

Notez que le actuel ExecutionStrategy n’est pas utilisé par cette méthode, car le sql n’est peut-être pas idempotent et ne s’exécute pas dans une transaction. Une stratégie d’exécution peut être utilisée explicitement, en veillant à utiliser également une transaction si le code SQL n’est pas idempotent.

Comme pour toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection de code SQL. Vous pouvez inclure des espaces réservés de paramètres dans la chaîne de requête SQL, puis fournir des valeurs de paramètre en tant qu’arguments supplémentaires. Toutes les valeurs de paramètre que vous fournissez sont automatiquement converties en DbParameter - context.Database.ExecuteSqlCommand("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm). Vous pouvez également envisager d’utiliser ExecuteSqlInterpolated pour utiliser la syntaxe de chaîne interpolée pour créer des paramètres.

ExecuteSqlCommand(DatabaseFacade, String, Object[])

Méthodes d’extension pour le DatabaseFacade retourné par Database qui ne peuvent être utilisées qu’avec des fournisseurs de base de données relationnelle.

ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken)
Obsolète.

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

Notez que cette méthode ne démarre pas une transaction. Pour utiliser cette méthode avec une transaction, appelez BeginTransaction(DatabaseFacade, IsolationLevel) d’abord ou UseTransaction(DatabaseFacade, DbTransaction).

Notez que le actuel ExecutionStrategy n’est pas utilisé par cette méthode, car le sql n’est peut-être pas idempotent et ne s’exécute pas dans une transaction. Une stratégie d’exécution peut être utilisée explicitement, en veillant à utiliser également une transaction si le code SQL n’est pas idempotent.

Comme pour toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection de code SQL. Vous pouvez inclure des espaces réservés de paramètres dans la chaîne de requête SQL, puis fournir des valeurs de paramètre en tant qu’arguments supplémentaires. Toutes les valeurs de paramètre que vous fournissez sont automatiquement converties en DbParameter - context.Database.ExecuteSqlCommandAsync($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken)
Obsolète.

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

Notez que cette méthode ne démarre pas une transaction. Pour utiliser cette méthode avec une transaction, appelez BeginTransaction(DatabaseFacade, IsolationLevel) d’abord ou UseTransaction(DatabaseFacade, DbTransaction).

Notez que le actuel ExecutionStrategy n’est pas utilisé par cette méthode, car le sql n’est peut-être pas idempotent et ne s’exécute pas dans une transaction. Une stratégie d’exécution peut être utilisée explicitement, en veillant à utiliser également une transaction si le code SQL n’est pas idempotent.

Comme pour toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection de code SQL. Vous pouvez inclure des espaces réservés de paramètres dans la chaîne de requête SQL, puis fournir des valeurs de paramètre en tant qu’arguments supplémentaires. Toutes les valeurs de paramètre que vous fournissez sont automatiquement converties en DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken)
Obsolète.

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

Notez que cette méthode ne démarre pas une transaction. Pour utiliser cette méthode avec une transaction, appelez BeginTransaction(DatabaseFacade, IsolationLevel) d’abord ou UseTransaction(DatabaseFacade, DbTransaction).

Notez que le actuel ExecutionStrategy n’est pas utilisé par cette méthode, car le sql n’est peut-être pas idempotent et ne s’exécute pas dans une transaction. Une stratégie d’exécution peut être utilisée explicitement, en veillant à utiliser également une transaction si le code SQL n’est pas idempotent.

Comme pour toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection de code SQL. Vous pouvez inclure des espaces réservés de paramètres dans la chaîne de requête SQL, puis fournir des valeurs de paramètre en tant qu’arguments supplémentaires. Toutes les valeurs de paramètre que vous fournissez sont automatiquement converties en DbParameter. Vous pouvez également envisager d’utiliser ExecuteSqlInterpolated pour utiliser la syntaxe de chaîne interpolée pour créer des paramètres.

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[])
Obsolète.

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

Notez que cette méthode ne démarre pas une transaction. Pour utiliser cette méthode avec une transaction, appelez BeginTransaction(DatabaseFacade, IsolationLevel) d’abord ou UseTransaction(DatabaseFacade, DbTransaction).

Notez que le actuel ExecutionStrategy n’est pas utilisé par cette méthode, car le sql n’est peut-être pas idempotent et ne s’exécute pas dans une transaction. Une stratégie d’exécution peut être utilisée explicitement, en veillant à utiliser également une transaction si le code SQL n’est pas idempotent.

Comme pour toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection de code SQL. Vous pouvez inclure des espaces réservés de paramètres dans la chaîne de requête SQL, puis fournir des valeurs de paramètre en tant qu’arguments supplémentaires. Toutes les valeurs de paramètre que vous fournissez sont automatiquement converties en DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm). Vous pouvez également envisager d’utiliser ExecuteSqlInterpolated pour utiliser la syntaxe de chaîne interpolée pour créer des paramètres.

ExecuteSqlCommandAsync(DatabaseFacade, String, CancellationToken, Object[])

Méthodes d’extension pour le DatabaseFacade retourné par Database qui ne peuvent être utilisées qu’avec des fournisseurs de base de données relationnelle.

ExecuteSqlInterpolated(DatabaseFacade, FormattableString)

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

ExecuteSqlInterpolatedAsync(DatabaseFacade, FormattableString, CancellationToken)

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>)

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

ExecuteSqlRaw(DatabaseFacade, String, Object[])

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

ExecuteSqlRawAsync(DatabaseFacade, String, CancellationToken)

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

ExecuteSqlRawAsync(DatabaseFacade, String, IEnumerable<Object>, CancellationToken)

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

ExecuteSqlRawAsync(DatabaseFacade, String, Object[])

Exécute le code SQL donné sur la base de données et retourne le nombre de lignes affectées.

GenerateCreateScript(DatabaseFacade)

Génère un script pour créer toutes les tables pour le modèle actuel.

GetAppliedMigrations(DatabaseFacade)

Obtient toutes les migrations qui ont été appliquées à la base de données cible.

GetAppliedMigrationsAsync(DatabaseFacade, CancellationToken)

Obtient de façon asynchrone toutes les migrations qui ont été appliquées à la base de données cible.

GetCommandTimeout(DatabaseFacade)

Retourne le délai d’expiration (en secondes) défini pour les commandes exécutées avec ce DbContext.

GetConnectionString(DatabaseFacade)

Obtient le chaîne de connexion sous-jacent configuré pour ce DbContext.

GetDbConnection(DatabaseFacade)

Obtient le ADO.NET DbConnection sous-jacent pour ce DbContext.

GetMigrations(DatabaseFacade)

Obtient toutes les migrations définies dans l’assembly de migrations configuré.

GetPendingMigrations(DatabaseFacade)

Obtient toutes les migrations définies dans l’assembly mais qui n’ont pas été appliquées à la base de données cible.

GetPendingMigrationsAsync(DatabaseFacade, CancellationToken)

Obtient de manière asynchrone toutes les migrations qui sont définies dans l’assembly mais qui n’ont pas été appliquées à la base de données cible.

HasPendingModelChanges(DatabaseFacade)

Retourne true si le modèle a des modifications en attente à appliquer.

IsRelational(DatabaseFacade)

Retourne true si le fournisseur de base de données actuellement utilisé est une base de données relationnelle.

Migrate(DatabaseFacade)

Applique toutes les migrations en attente pour le contexte à la base de données. Crée la base de données si elle n’existe pas déjà.

MigrateAsync(DatabaseFacade, CancellationToken)

Applique de manière asynchrone toutes les migrations en attente pour le contexte à la base de données. Crée la base de données si elle n’existe pas déjà.

OpenConnection(DatabaseFacade)

Ouvre le sous-jacent DbConnection.

OpenConnectionAsync(DatabaseFacade, CancellationToken)

Ouvre le sous-jacent DbConnection.

SetCommandTimeout(DatabaseFacade, Nullable<Int32>)

Définit le délai d’expiration (en secondes) à utiliser pour les commandes exécutées avec ce DbContext.

SetCommandTimeout(DatabaseFacade, TimeSpan)

Définit le délai d’expiration à utiliser pour les commandes exécutées avec ce DbContext.

SetConnectionString(DatabaseFacade, String)

Définit le chaîne de connexion sous-jacent configuré pour ce DbContext.

SetDbConnection(DatabaseFacade, DbConnection)

Définit le ADO.NET DbConnection sous-jacent pour ce DbContext.

SetDbConnection(DatabaseFacade, DbConnection, Boolean)

Définit le ADO.NET DbConnection sous-jacent pour ce DbContext.

SqlQuery<TResult>(DatabaseFacade, FormattableString)

Crée une requête LINQ basée sur une requête SQL brute, qui retourne un jeu de résultats d’un type scalaire pris en charge en mode natif par le fournisseur de base de données.

SqlQueryRaw<TResult>(DatabaseFacade, String, Object[])

Crée une requête LINQ basée sur une requête SQL brute, qui retourne un jeu de résultats d’un type scalaire pris en charge en mode natif par le fournisseur de base de données.

UseTransaction(DatabaseFacade, DbTransaction)

Définit le à utiliser par les DbTransaction opérations de base de données sur le DbContext.

UseTransaction(DatabaseFacade, DbTransaction, Guid)

Définit le à utiliser par les DbTransaction opérations de base de données sur le DbContext.

UseTransactionAsync(DatabaseFacade, DbTransaction, CancellationToken)

Définit le à utiliser par les DbTransaction opérations de base de données sur le DbContext.

UseTransactionAsync(DatabaseFacade, DbTransaction, Guid, CancellationToken)

Définit le à utiliser par les DbTransaction opérations de base de données sur le DbContext.

S’applique à