Partilhar via

RelationalDatabaseFacadeExtensions Classe

  • Referência

Definição

Namespace:
Microsoft.EntityFrameworkCore
Assembly:
Microsoft.EntityFrameworkCore.Relational.dll
Pacote:
Microsoft.EntityFrameworkCore.Relational v1.0.6
Pacote:
Microsoft.EntityFrameworkCore.Relational v1.1.6
Pacote:
Microsoft.EntityFrameworkCore.Relational v2.0.3
Pacote:
Microsoft.EntityFrameworkCore.Relational v2.1.11
Pacote:
Microsoft.EntityFrameworkCore.Relational v2.2.6
Pacote:
Microsoft.EntityFrameworkCore.Relational v3.0.0
Pacote:
Microsoft.EntityFrameworkCore.Relational v3.1.0
Pacote:
Microsoft.EntityFrameworkCore.Relational v5.0.0
Pacote:
Microsoft.EntityFrameworkCore.Relational v6.0.0
Pacote:
Microsoft.EntityFrameworkCore.Relational v7.0.0
Pacote:
Microsoft.EntityFrameworkCore.Relational v8.0.0

Métodos de extensão para o DatabaseFacade retornado de Database que só podem ser usados com provedores de banco de dados relacionais.

public static class RelationalDatabaseFacadeExtensions
type RelationalDatabaseFacadeExtensions = class
Public Module RelationalDatabaseFacadeExtensions
Herança
Object
RelationalDatabaseFacadeExtensions

Métodos

BeginTransaction(DatabaseFacade, IsolationLevel)

Inicia uma nova transação com um determinado IsolationLevel.
BeginTransactionAsync(DatabaseFacade, IsolationLevel, CancellationToken)

Inicia de forma assíncrona uma nova transação com um determinado IsolationLevel.
CloseConnection(DatabaseFacade)

Fecha o subjacente DbConnection.
CloseConnectionAsync(DatabaseFacade)

Fecha o subjacente DbConnection.
ExecuteSql(DatabaseFacade, FormattableString)

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.
ExecuteSqlAsync(DatabaseFacade, FormattableString, CancellationToken)

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.
ExecuteSqlCommand(DatabaseFacade, FormattableString)
Obsoleto.

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.

Observe que esse método não inicia uma transação. Para usar esse método com uma transação, primeira chamada BeginTransaction(DatabaseFacade, IsolationLevel) ou UseTransaction(DatabaseFacade, DbTransaction).

Observe que o atual ExecutionStrategy não é usado por esse método, pois o SQL pode não ser idempotente e não é executado em uma transação. Um ExecutionStrategy pode ser usado explicitamente, certificando-se de também usar uma transação se o SQL não for idempotente.

Assim como acontece com qualquer API que aceite o SQL, é importante parametrizar qualquer entrada de usuário para proteger contra um ataque de injeção de SQL. Você pode incluir detentores de parâmetros na cadeia de caracteres de consulta SQL e, em seguida, fornecer valores de parâmetro como argumentos adicionais. Todos os valores de parâmetro fornecidos serão convertidos automaticamente em um DbParameter – context.Database.ExecuteSqlCommand($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").

ExecuteSqlCommand(DatabaseFacade, RawSqlString, IEnumerable<Object>)
Obsoleto.

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.

Observe que esse método não inicia uma transação. Para usar esse método com uma transação, primeira chamada BeginTransaction(DatabaseFacade, IsolationLevel) ou UseTransaction(DatabaseFacade, DbTransaction).

Observe que o atual ExecutionStrategy não é usado por esse método, pois o SQL pode não ser idempotente e não é executado em uma transação. Um ExecutionStrategy pode ser usado explicitamente, certificando-se de também usar uma transação se o SQL não for idempotente.

Assim como acontece com qualquer API que aceite o SQL, é importante parametrizar qualquer entrada de usuário para proteger contra um ataque de injeção de SQL. Você pode incluir detentores de parâmetros na cadeia de caracteres de consulta SQL e, em seguida, fornecer valores de parâmetro como argumentos adicionais. Todos os valores de parâmetro fornecidos serão convertidos automaticamente em um DbParameter. Você também pode considerar o uso de ExecuteSqlInterpolated para usar a sintaxe de cadeia de caracteres interpolada para criar parâmetros.

ExecuteSqlCommand(DatabaseFacade, RawSqlString, Object[])
Obsoleto.

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.

Observe que esse método não inicia uma transação. Para usar esse método com uma transação, primeira chamada BeginTransaction(DatabaseFacade, IsolationLevel) ou UseTransaction(DatabaseFacade, DbTransaction).

Observe que o atual ExecutionStrategy não é usado por esse método, pois o SQL pode não ser idempotente e não é executado em uma transação. Um ExecutionStrategy pode ser usado explicitamente, certificando-se de também usar uma transação se o SQL não for idempotente.

Assim como acontece com qualquer API que aceite o SQL, é importante parametrizar qualquer entrada de usuário para proteger contra um ataque de injeção de SQL. Você pode incluir detentores de parâmetros na cadeia de caracteres de consulta SQL e, em seguida, fornecer valores de parâmetro como argumentos adicionais. Todos os valores de parâmetro fornecidos serão convertidos automaticamente em um DbParameter – context.Database.ExecuteSqlCommand("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm). Você também pode considerar o uso de ExecuteSqlInterpolated para usar a sintaxe de cadeia de caracteres interpolada para criar parâmetros.

ExecuteSqlCommand(DatabaseFacade, String, Object[])

Métodos de extensão para o DatabaseFacade retornado de Database que só podem ser usados com provedores de banco de dados relacionais.
ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken)
Obsoleto.

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.

Observe que esse método não inicia uma transação. Para usar esse método com uma transação, primeira chamada BeginTransaction(DatabaseFacade, IsolationLevel) ou UseTransaction(DatabaseFacade, DbTransaction).

Observe que o atual ExecutionStrategy não é usado por esse método, pois o SQL pode não ser idempotente e não é executado em uma transação. Um ExecutionStrategy pode ser usado explicitamente, certificando-se de também usar uma transação se o SQL não for idempotente.

Assim como acontece com qualquer API que aceite o SQL, é importante parametrizar qualquer entrada de usuário para proteger contra um ataque de injeção de SQL. Você pode incluir detentores de parâmetros na cadeia de caracteres de consulta SQL e, em seguida, fornecer valores de parâmetro como argumentos adicionais. Todos os valores de parâmetro fornecidos serão convertidos automaticamente em um DbParameter – context.Database.ExecuteSqlCommandAsync($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken)
Obsoleto.

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.

Observe que esse método não inicia uma transação. Para usar esse método com uma transação, primeira chamada BeginTransaction(DatabaseFacade, IsolationLevel) ou UseTransaction(DatabaseFacade, DbTransaction).

Observe que o atual ExecutionStrategy não é usado por esse método, pois o SQL pode não ser idempotente e não é executado em uma transação. Um ExecutionStrategy pode ser usado explicitamente, certificando-se de também usar uma transação se o SQL não for idempotente.

Assim como acontece com qualquer API que aceite o SQL, é importante parametrizar qualquer entrada de usuário para proteger contra um ataque de injeção de SQL. Você pode incluir detentores de parâmetros na cadeia de caracteres de consulta SQL e, em seguida, fornecer valores de parâmetro como argumentos adicionais. Todos os valores de parâmetro fornecidos serão convertidos automaticamente em um DbParameter – context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken)
Obsoleto.

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.

Observe que esse método não inicia uma transação. Para usar esse método com uma transação, primeira chamada BeginTransaction(DatabaseFacade, IsolationLevel) ou UseTransaction(DatabaseFacade, DbTransaction).

Observe que o atual ExecutionStrategy não é usado por esse método, pois o SQL pode não ser idempotente e não é executado em uma transação. Um ExecutionStrategy pode ser usado explicitamente, certificando-se de também usar uma transação se o SQL não for idempotente.

Assim como acontece com qualquer API que aceite o SQL, é importante parametrizar qualquer entrada de usuário para proteger contra um ataque de injeção de SQL. Você pode incluir detentores de parâmetros na cadeia de caracteres de consulta SQL e, em seguida, fornecer valores de parâmetro como argumentos adicionais. Todos os valores de parâmetro fornecidos serão convertidos automaticamente em um DbParameter. Você também pode considerar o uso de ExecuteSqlInterpolated para usar a sintaxe de cadeia de caracteres interpolada para criar parâmetros.

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[])
Obsoleto.

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.

Observe que esse método não inicia uma transação. Para usar esse método com uma transação, primeira chamada BeginTransaction(DatabaseFacade, IsolationLevel) ou UseTransaction(DatabaseFacade, DbTransaction).

Observe que o atual ExecutionStrategy não é usado por esse método, pois o SQL pode não ser idempotente e não é executado em uma transação. Um ExecutionStrategy pode ser usado explicitamente, certificando-se de também usar uma transação se o SQL não for idempotente.

Assim como acontece com qualquer API que aceite o SQL, é importante parametrizar qualquer entrada de usuário para proteger contra um ataque de injeção de SQL. Você pode incluir detentores de parâmetros na cadeia de caracteres de consulta SQL e, em seguida, fornecer valores de parâmetro como argumentos adicionais. Todos os valores de parâmetro fornecidos serão convertidos automaticamente em um DbParameter – context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm). Você também pode considerar o uso de ExecuteSqlInterpolated para usar a sintaxe de cadeia de caracteres interpolada para criar parâmetros.

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

Métodos de extensão para o DatabaseFacade retornado de Database que só podem ser usados com provedores de banco de dados relacionais.
ExecuteSqlInterpolated(DatabaseFacade, FormattableString)

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.
ExecuteSqlInterpolatedAsync(DatabaseFacade, FormattableString, CancellationToken)

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.
ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>)

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.
ExecuteSqlRaw(DatabaseFacade, String, Object[])

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.
ExecuteSqlRawAsync(DatabaseFacade, String, CancellationToken)

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.
ExecuteSqlRawAsync(DatabaseFacade, String, IEnumerable<Object>, CancellationToken)

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.
ExecuteSqlRawAsync(DatabaseFacade, String, Object[])

Executa o SQL especificado no banco de dados e retorna o número de linhas afetadas.
GenerateCreateScript(DatabaseFacade)

Gera um script para criar todas as tabelas para o modelo atual.
GetAppliedMigrations(DatabaseFacade)

Obtém todas as migrações que foram aplicadas ao banco de dados de destino.
GetAppliedMigrationsAsync(DatabaseFacade, CancellationToken)

Obtém de forma assíncrona todas as migrações que foram aplicadas ao banco de dados de destino.
GetCommandTimeout(DatabaseFacade)

Retorna o tempo limite (em segundos) definido para comandos executados com este DbContext.
GetConnectionString(DatabaseFacade)

Obtém o cadeia de conexão subjacente configurado para este DbContext.
GetDbConnection(DatabaseFacade)

Obtém o ADO.NET DbConnection subjacente para este DbContext.
GetMigrations(DatabaseFacade)

Obtém todas as migrações definidas no assembly de migrações configurado.
GetPendingMigrations(DatabaseFacade)

Obtém todas as migrações definidas no assembly, mas que não foram aplicadas ao banco de dados de destino.
GetPendingMigrationsAsync(DatabaseFacade, CancellationToken)

Obtém de forma assíncrona todas as migrações definidas no assembly, mas que não foram aplicadas ao banco de dados de destino.
HasPendingModelChanges(DatabaseFacade)

Retornará true se o modelo tiver alterações pendentes a serem aplicadas.
IsRelational(DatabaseFacade)

Retornará true se o provedor de banco de dados atualmente em uso for um banco de dados relacional.
Migrate(DatabaseFacade)

Aplica todas as migrações pendentes para o contexto para o banco de dados. Criará o banco de dados se ele ainda não existir.
MigrateAsync(DatabaseFacade, CancellationToken)

Aplica de forma assíncrona todas as migrações pendentes para o contexto para o banco de dados. Criará o banco de dados se ele ainda não existir.
OpenConnection(DatabaseFacade)

Abre o subjacente DbConnection.
OpenConnectionAsync(DatabaseFacade, CancellationToken)

Abre o subjacente DbConnection.
SetCommandTimeout(DatabaseFacade, Nullable<Int32>)

Define o tempo limite (em segundos) a ser usado para comandos executados com este DbContext.
SetCommandTimeout(DatabaseFacade, TimeSpan)

Define o tempo limite a ser usado para comandos executados com este DbContext.
SetConnectionString(DatabaseFacade, String)

Define o cadeia de conexão subjacente configurado para este DbContext.
SetDbConnection(DatabaseFacade, DbConnection, Boolean)

Define o ADO.NET DbConnection subjacente para este DbContext.
SetDbConnection(DatabaseFacade, DbConnection)

Define o ADO.NET DbConnection subjacente para este DbContext.
SqlQuery<TResult>(DatabaseFacade, FormattableString)

Cria uma consulta LINQ com base em uma consulta SQL bruta, que retorna um conjunto de resultados de um tipo escalar com suporte nativo pelo provedor de banco de dados.
SqlQueryRaw<TResult>(DatabaseFacade, String, Object[])

Cria uma consulta LINQ com base em uma consulta SQL bruta, que retorna um conjunto de resultados de um tipo escalar com suporte nativo pelo provedor de banco de dados.
UseTransaction(DatabaseFacade, DbTransaction, Guid)

Define o DbTransaction a ser usado por operações de banco de dados no DbContext.
UseTransaction(DatabaseFacade, DbTransaction)

Define o DbTransaction a ser usado por operações de banco de dados no DbContext.
UseTransactionAsync(DatabaseFacade, DbTransaction, CancellationToken)

Define o DbTransaction a ser usado por operações de banco de dados no DbContext.
UseTransactionAsync(DatabaseFacade, DbTransaction, Guid, CancellationToken)

Define o DbTransaction a ser usado por operações de banco de dados no DbContext.

Aplica-se a