DataContext Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa o ponto de entrada principal da estrutura LINQ to SQL.
public ref class DataContext : IDisposable
public class DataContext : IDisposable
type DataContext = class
interface IDisposable
Public Class DataContext
Implements IDisposable
- Herança
-
DataContext
- Implementações
Comentários
A DataContext origem de todas as entidades mapeadas em uma conexão de banco de dados. Ele rastreia as alterações feitas em todas as entidades recuperadas e mantém um "cache de identidade" que garante que as entidades recuperadas mais de uma vez sejam representadas usando a mesma instância de objeto.
Em geral, uma DataContext instância foi projetada para durar para uma "unidade de trabalho", no entanto, seu aplicativo define esse termo. Um DataContext é leve e não é caro de criar. Um aplicativo LINQ to SQL típico cria DataContext instâncias no escopo do método ou como membro de classes de curta duração que representam um conjunto lógico de operações de banco de dados relacionadas.
Construtores
| Nome | Description |
|---|---|
| DataContext(IDbConnection, MappingSource) |
Inicializa uma nova instância da DataContext classe referenciando uma conexão e uma fonte de mapeamento. |
| DataContext(IDbConnection) |
Inicializa uma nova instância da classe DataContext referenciando a conexão usada pelo .NET Framework. |
| DataContext(String, MappingSource) |
Inicializa uma nova instância da DataContext classe referenciando uma fonte de arquivo e uma fonte de mapeamento. |
| DataContext(String) |
Inicializa uma nova instância da classe fazendo referência a DataContext uma fonte de arquivo. |
Propriedades
| Nome | Description |
|---|---|
| ChangeConflicts |
Obtém uma coleção de objetos que causou conflitos de simultaneidade quando SubmitChanges() foi chamado. |
| CommandTimeout |
Obtém ou define um valor que aumenta o período de tempo limite (em segundos) para consultas que, de outra forma, acabariam durante o período de tempo limite padrão. |
| Connection |
Obtém a conexão usada pela estrutura. |
| DeferredLoadingEnabled |
Obtém ou define um valor que indica se as relações um para muitos ou um para um devem ser carregadas com atraso. |
| LoadOptions |
Obtém ou define o DataLoadOptions associado a isso DataContext. |
| Log |
Obtém ou define o destino para gravar a consulta ou o comando SQL. |
| Mapping |
Obtém o MetaModel no qual o mapeamento é baseado. |
| ObjectTrackingEnabled |
Obtém ou define um valor que indica se o controle de objetos está habilitado. |
| Transaction |
Obtém ou define uma transação local para o .NET Framework a ser usada para acessar o banco de dados. |
Métodos
| Nome | Description |
|---|---|
| CreateDatabase() |
Cria um banco de dados no servidor. |
| CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) |
Executa a função de banco de dados com valor de tabela associada ao método .NET especificado. |
| DatabaseExists() |
Determina se o banco de dados associado pode ser aberto. |
| DeleteDatabase() |
Exclui o banco de dados associado. |
| Dispose() |
Libera todos os recursos usados pela instância atual da DataContext classe. |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pela DataContext classe e, opcionalmente, libera o recurso gerenciado. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| ExecuteCommand(String, Object[]) |
Executa comandos SQL diretamente no banco de dados. |
| ExecuteDynamicDelete(Object) |
Executa, dentro dos métodos de substituição de exclusão, para redefinir para LINQ para SQL a tarefa de gerar e executar o SQL dinâmico para operações de exclusão. |
| ExecuteDynamicInsert(Object) |
Executa, dentro dos métodos de substituição de inserção, para redelegar para LINQ para SQL a tarefa de gerar e executar o SQL dinâmico para operações de inserção. |
| ExecuteDynamicUpdate(Object) |
Executa, dentro de métodos de substituição de atualização, para redefinir para LINQ para SQL a tarefa de gerar e executar o SQL dinâmico para operações de atualização. |
| ExecuteMethodCall(Object, MethodInfo, Object[]) |
Executa o procedimento de banco de dados armazenado ou a função escalar associada ao método .NET especificado. |
| ExecuteQuery(Type, String, Object[]) |
Executa consultas SQL diretamente no banco de dados. |
| ExecuteQuery<TResult>(String, Object[]) |
Executa consultas SQL diretamente no banco de dados e retorna objetos. |
| GetChangeSet() |
Obtém os objetos modificados rastreados por DataContext. |
| GetCommand(IQueryable) |
Obtém as informações sobre os comandos SQL gerados pelo LINQ to SQL. |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetTable(Type) |
Retorna uma coleção de objetos de um tipo específico, em que o tipo é definido pelo |
| GetTable<TEntity>() |
Retorna uma coleção de objetos de um tipo específico, em que o tipo é definido pelo |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| Refresh(RefreshMode, IEnumerable) |
Atualiza uma coleção de objetos de entidade de acordo com o modo especificado. |
| Refresh(RefreshMode, Object) |
Atualiza um objeto de entidade de acordo com o modo especificado. |
| Refresh(RefreshMode, Object[]) |
Atualiza uma matriz de objetos de entidade de acordo com o modo especificado. |
| SubmitChanges() |
Calcula o conjunto de objetos modificados a serem inseridos, atualizados ou excluídos e executa os comandos apropriados para implementar as alterações no banco de dados. |
| SubmitChanges(ConflictMode) |
Envia alterações feitas para objetos recuperados para o banco de dados subjacente e especifica a ação a ser tomada se o envio falhar. |
| ToString() |
Retorna uma cadeia de caracteres 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. |