DataContext Classe

Definição

Espaço de Nomes:
System.Data.Linq
Assemblagem:
System.Data.Linq.dll

Representa o principal ponto de entrada para o framework LINQ para SQL.

public ref class DataContext : IDisposable
public class DataContext : IDisposable
type DataContext = class
    interface IDisposable
Public Class DataContext
Implements IDisposable
Herança
Object
DataContext
Implementações
IDisposable

Observações

É DataContext a origem de todas as entidades mapeadas sobre uma ligação à base de dados. Regista as alterações feitas a todas as entidades recuperadas e mantém um "cache de identidade" que garante que as entidades recuperadas mais do que uma vez são representadas usando a mesma instância de objetos.

Em geral, uma DataContext instância é concebida para durar uma "unidade de trabalho", independentemente da definição que a sua aplicação defina esse termo. A DataContext é leve e não é caro de criar. Uma aplicação típica de LINQ para SQL cria DataContext instâncias no âmbito do método ou como membro de classes de curta duração que representam um conjunto lógico de operações relacionadas na base de dados.

Construtores

Name Description
DataContext(IDbConnection, MappingSource)

Inicializa uma nova instância da DataContext classe ao referenciar uma ligação e uma fonte de mapeamento.
DataContext(IDbConnection)

Inicializa uma nova instância da classe DataContext referenciando a ligação usada pelo .NET Framework.
DataContext(String, MappingSource)

Inicializa uma nova instância da DataContext classe referenciando uma fonte de ficheiro e uma fonte de mapeamento.
DataContext(String)

Inicializa uma nova instância da DataContext classe ao referenciar uma fonte de ficheiro.

Propriedades

Name Description
ChangeConflicts

Recebe uma coleção de objetos que causaram conflitos de concorrência quando SubmitChanges() foram chamados.
CommandTimeout

Recebe ou define um valor que aumenta o período de tempo de espera (em segundos) para consultas que, de outra forma, expirariam durante o período de tempo de espera padrão.
Connection

Obtém a ligação usada pelo framework.
DeferredLoadingEnabled

Recebe ou define um valor que indica se deve atrasar o carregamento de relações um-para-muitos ou um-para-um.
LoadOptions

Obtém ou define o DataLoadOptions associado a este DataContext.
Log

Recebe ou define o destino para escrever a consulta SQL ou comando.
Mapping

Obtém a MetaModel base em que o mapeamento se baseia.
ObjectTrackingEnabled

Recebe ou define um valor que indica se o rastreamento de objetos está ativado.
Transaction

Obtém ou define uma transação local para o .NET Framework aceder à base de dados.

Métodos

Name Description
CreateDatabase()

Cria uma base de dados no servidor.
CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[])

Executa a função de base de dados com valores de tabela associada ao método .NET especificado.
DatabaseExists()

Determina se a base de dados associada pode ser aberta.
DeleteDatabase()

Apaga a base de dados associada.
Dispose()

Liberta todos os recursos usados pela instância atual da DataContext classe.
Dispose(Boolean)

Liberta os recursos não geridos usados pela DataContext classe e, opcionalmente, liberta o recurso gerido.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
ExecuteCommand(String, Object[])

Executa comandos SQL diretamente na base de dados.
ExecuteDynamicDelete(Object)

Executa, dentro dos métodos de substituição de eliminação, para redelegar ao LINQ para SQL a tarefa de gerar e executar SQL dinâmico para operações de eliminação.
ExecuteDynamicInsert(Object)

Executa, dentro dos métodos de substituição de inserção, para redelegar ao LINQ para SQL a tarefa de gerar e executar SQL dinâmico para operações de inserção.
ExecuteDynamicUpdate(Object)

Executa, dentro de métodos de substituição de atualização, para redelegar ao LINQ para SQL a tarefa de gerar e executar SQL dinâmico para operações de atualização.
ExecuteMethodCall(Object, MethodInfo, Object[])

Executa o procedimento de base de dados armazenado ou função escalar associada ao método .NET especificado.
ExecuteQuery(Type, String, Object[])

Executa consultas SQL diretamente na base de dados.
ExecuteQuery<TResult>(String, Object[])

Executa consultas SQL diretamente na base de dados e devolve objetos.
GetChangeSet()

Faz com que os objetos modificados sejam rastreados por DataContext.
GetCommand(IQueryable)

Obtém a informação sobre comandos SQL gerados pelo LINQ para SQL.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetTable(Type)

Devolve uma coleção de objetos de um tipo particular, onde o tipo é definido pelo type parâmetro.
GetTable<TEntity>()

Devolve uma coleção de objetos de um tipo particular, onde o tipo é definido pelo TEntity parâmetro.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Refresh(RefreshMode, IEnumerable)

Atualiza uma coleção de objetos entidade de acordo com o modo especificado.
Refresh(RefreshMode, Object)

Atualiza um objeto entidade de acordo com o modo especificado.
Refresh(RefreshMode, Object[])

Atualiza um array de objetos entidade de acordo com o modo especificado.
SubmitChanges()

Calcula o conjunto de objetos modificados a serem inseridos, atualizados ou eliminados, e executa os comandos apropriados para implementar as alterações na base de dados.
SubmitChanges(ConflictMode)

Envia as alterações feitas aos objetos recuperados para a base de dados subjacente e especifica a ação a tomar caso a submissão falhe.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
Translate(DbDataReader)

Converte um existente DbDataReader em objetos.
Translate(Type, DbDataReader)

Converte um existente DbDataReader em objetos.
Translate<TResult>(DbDataReader)

Converte um existente DbDataReader em objetos.

Aplica-se a