DataContext DataContext DataContext DataContext Class

Definição

Representa o ponto de entrada principal para a estrutura de LINQ to SQL.Represents the main entry point for the LINQ to SQL framework.

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

Comentários

O DataContext é a origem de todas as entidades mapeadas em uma conexão de banco de dados.The DataContext is the source of all entities mapped over a database connection. Ele controla 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.It tracks changes that you made to all retrieved entities and maintains an "identity cache" that guarantees that entities retrieved more than one time are represented by using the same object instance.

Em geral, uma DataContext instância é projetada para durar uma "unidade de trabalho", no entanto, o aplicativo define esse termo.In general, a DataContext instance is designed to last for one "unit of work" however your application defines that term. Um DataContext é leve e não é caro de criar.A DataContext is lightweight and is not expensive to create. Um aplicativo LINQ to SQLLINQ to SQL típico cria DataContext instâncias no escopo do método ou como um membro de classes de curta duração que representam um conjunto lógico de operações de banco de dados relacionadas.A typical LINQ to SQLLINQ to SQL application creates DataContext instances at method scope or as a member of short-lived classes that represent a logical set of related database operations.

Construtores

DataContext(IDbConnection) DataContext(IDbConnection) DataContext(IDbConnection) DataContext(IDbConnection)

Inicializa uma nova instância da classe DataContext referenciando a conexão usada pelo .NET Framework.NET Framework.Initializes a new instance of the DataContext class by referencing the connection used by the .NET Framework.NET Framework.

DataContext(IDbConnection, MappingSource) DataContext(IDbConnection, MappingSource) DataContext(IDbConnection, MappingSource) DataContext(IDbConnection, MappingSource)

Inicializa uma nova instância da classe DataContext referenciando uma conexão e uma fonte de mapeamento.Initializes a new instance of the DataContext class by referencing a connection and a mapping source.

DataContext(String) DataContext(String) DataContext(String) DataContext(String)

Inicializa uma nova instância da classe DataContext referenciando uma fonte de arquivo.Initializes a new instance of the DataContext class by referencing a file source.

DataContext(String, MappingSource) DataContext(String, MappingSource) DataContext(String, MappingSource) DataContext(String, MappingSource)

Inicializa uma nova instância da classe DataContext referenciando uma fonte de arquivo e fonte de mapeamento.Initializes a new instance of the DataContext class by referencing a file source and a mapping source.

Propriedades

ChangeConflicts ChangeConflicts ChangeConflicts ChangeConflicts

Obtém uma coleção de objetos que causaram conflitos de simultaneidade quando o SubmitChanges() foi chamado.Gets a collection of objects that caused concurrency conflicts when SubmitChanges() was called.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

Obtém ou define um valor que aumenta o período de tempo limite (em segundos) para consultas que, de outra forma, atingiriam o tempo limite durante o período de tempo limite padrão.Gets or sets a value that increases the time-out period (in seconds) for queries that would otherwise time out during the default time-out period.

Connection Connection Connection Connection

Obtém a conexão usada pela estrutura.Gets the connection used by the framework.

DeferredLoadingEnabled DeferredLoadingEnabled DeferredLoadingEnabled DeferredLoadingEnabled

Obtém ou define um valor que indica se relações de um-para-muitos ou de um-para-um devem ter o carregamento adiado.Gets or sets a value that indicates whether to delay-load one-to-many or one-to-one relationships.

LoadOptions LoadOptions LoadOptions LoadOptions

Obtém ou define o DataLoadOptions associado a esse DataContext.Gets or sets the DataLoadOptions associated with this DataContext.

Log Log Log Log

Obtém ou define o destino para escrever a consulta ou o comando SQL.Gets or sets the destination to write the SQL query or command.

Mapping Mapping Mapping Mapping

Obtém o MetaModel no qual o mapeamento é baseado.Gets the MetaModel on which the mapping is based.

ObjectTrackingEnabled ObjectTrackingEnabled ObjectTrackingEnabled ObjectTrackingEnabled

Obtém ou define um valor que indica se o rastreamento do objeto está habilitado.Gets or sets a value that indicates whether object tracking is enabled.

QueryCacheEnabled QueryCacheEnabled QueryCacheEnabled QueryCacheEnabled
Transaction Transaction Transaction Transaction

Obtém ou define uma transação local para o .NET Framework.NET Framework para usar para acessar o banco de dados.Gets or sets a local transaction for the .NET Framework.NET Framework to use to access the database.

Métodos

CreateDatabase() CreateDatabase() CreateDatabase() CreateDatabase()

Cria um banco de dados no servidor.Creates a database on the server.

CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[]) CreateMethodCallQuery<TResult>(Object, MethodInfo, Object[])

Executa a função de banco de dados com valor de tabela associada ao método .NET especificado.Executes the table-valued database function associated with the specified .NET method.

DatabaseExists() DatabaseExists() DatabaseExists() DatabaseExists()

Determina se o banco de dados associado pode ser aberto.Determines whether the associated database can be opened.

DeleteDatabase() DeleteDatabase() DeleteDatabase() DeleteDatabase()

Exclui o banco de dados associado.Deletes the associated database.

Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pela instância atual da classe DataContext.Releases all resources used by the current instance of the DataContext class.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera os recursos não gerenciados usados pela classe DataContext e, opcionalmente, libera o recurso gerenciado.Releases the unmanaged resources used by the DataContext class and optionally releases the managed resource.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExecuteCommand(String, Object[]) ExecuteCommand(String, Object[]) ExecuteCommand(String, Object[]) ExecuteCommand(String, Object[])

Executa comandos SQL diretamente no banco de dados.Executes SQL commands directly on the database.

ExecuteDynamicDelete(Object) ExecuteDynamicDelete(Object) ExecuteDynamicDelete(Object) ExecuteDynamicDelete(Object)

É executado, dentro de métodos de substituição de exclusão, para redelegar para LINQ to SQLLINQ to SQL a tarefa de geração e execução de SQL dinâmico para operações de exclusão.Executes, inside delete override methods, to redelegate to LINQ to SQLLINQ to SQL the task of generating and executing dynamic SQL for delete operations.

ExecuteDynamicInsert(Object) ExecuteDynamicInsert(Object) ExecuteDynamicInsert(Object) ExecuteDynamicInsert(Object)

É executado, dentro de métodos de substituição de inserção, para delegar novamente para LINQ to SQLLINQ to SQL a tarefa de gerar e executar SQL dinâmico para operações de inserção.Executes, inside insert override methods, to redelegate to LINQ to SQLLINQ to SQL the task of generating and executing dynamic SQL for insert operations.

ExecuteDynamicUpdate(Object) ExecuteDynamicUpdate(Object) ExecuteDynamicUpdate(Object) ExecuteDynamicUpdate(Object)

É executado, dentro de métodos de substituição de atualização, para redelegar para LINQ to SQLLINQ to SQL a tarefa de geração e execução de SQL dinâmico para operações de atualização.Executes, inside update override methods, to redelegate to LINQ to SQLLINQ to SQL the task of generating and executing dynamic SQL for update operations.

ExecuteMethodCall(Object, MethodInfo, Object[]) ExecuteMethodCall(Object, MethodInfo, Object[]) ExecuteMethodCall(Object, MethodInfo, Object[]) ExecuteMethodCall(Object, MethodInfo, Object[])

Executa o procedimento armazenado do banco de dados ou a função escalar associada com o método .NET especificado.Executes the stored database procedure or scalar function associated with the specified .NET method.

ExecuteQuery(Type, String, Object[]) ExecuteQuery(Type, String, Object[]) ExecuteQuery(Type, String, Object[]) ExecuteQuery(Type, String, Object[])

Executa consultas SQL diretamente no banco de dados.Executes SQL queries directly on the database.

ExecuteQuery<TResult>(String, Object[]) ExecuteQuery<TResult>(String, Object[]) ExecuteQuery<TResult>(String, Object[]) ExecuteQuery<TResult>(String, Object[])

Executa consultas SQL diretamente no banco de dados e retorna objetos.Executes SQL queries directly on the database and returns objects.

GetChangeSet() GetChangeSet() GetChangeSet() GetChangeSet()

Obtém os objetos modificados controlados pelo DataContext.Gets the modified objects tracked by DataContext.

GetCommand(IQueryable) GetCommand(IQueryable) GetCommand(IQueryable) GetCommand(IQueryable)

Obtém as informações sobre os comandos SQL gerados pelo LINQ to SQLLINQ to SQL.Gets the information about SQL commands generated by LINQ to SQLLINQ to SQL.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetIDbCommand(IQueryable) GetIDbCommand(IQueryable) GetIDbCommand(IQueryable) GetIDbCommand(IQueryable)
GetTable(Type) GetTable(Type) GetTable(Type) GetTable(Type)

Retorna uma coleção de objetos de um tipo específico, em que o tipo é definido pelo parâmetro type.Returns a collection of objects of a particular type, where the type is defined by the type parameter.

GetTable<TEntity>() GetTable<TEntity>() GetTable<TEntity>() GetTable<TEntity>()

Retorna uma coleção de objetos de um tipo específico, em que o tipo é definido pelo parâmetro TEntity.Returns a collection of objects of a particular type, where the type is defined by the TEntity parameter.

GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
Refresh(RefreshMode, IEnumerable) Refresh(RefreshMode, IEnumerable) Refresh(RefreshMode, IEnumerable) Refresh(RefreshMode, IEnumerable)

Atualiza uma coleção de objetos de entidade de acordo com o modo especificado.Refreshes a collection of entity objects according to the specified mode.

Refresh(RefreshMode, Object) Refresh(RefreshMode, Object) Refresh(RefreshMode, Object) Refresh(RefreshMode, Object)

Atualiza um objeto de entidade de acordo com o modo especificado.Refreshes an entity object according to the specified mode.

Refresh(RefreshMode, Object[]) Refresh(RefreshMode, Object[]) Refresh(RefreshMode, Object[]) Refresh(RefreshMode, Object[])

Atualiza uma matriz de objetos de entidade de acordo com o modo especificado.Refreshes an array of entity objects according to the specified mode.

SubmitChanges() SubmitChanges() SubmitChanges() SubmitChanges()

Calcula o conjunto de objetos modificados a serem inseridos, atualizados ou excluídos e executa os comandos adequados para implementar as alterações no banco de dados.Computes the set of modified objects to be inserted, updated, or deleted, and executes the appropriate commands to implement the changes to the database.

SubmitChanges(ConflictMode) SubmitChanges(ConflictMode) SubmitChanges(ConflictMode) SubmitChanges(ConflictMode)

Envia as alterações que foram feitas para recuperar objetos de banco de dados subjacente e especifica a ação a ser tomada se o envio falhar.Sends changes that were made to retrieved objects to the underlying database, and specifies the action to be taken if the submission fails.

ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)
Translate(DbDataReader) Translate(DbDataReader) Translate(DbDataReader) Translate(DbDataReader)

Converte um DbDataReader existente em objetos.Converts an existing DbDataReader to objects.

Translate(Type, DbDataReader) Translate(Type, DbDataReader) Translate(Type, DbDataReader) Translate(Type, DbDataReader)

Converte um DbDataReader existente em objetos.Converts an existing DbDataReader to objects.

Translate<TResult>(DbDataReader) Translate<TResult>(DbDataReader) Translate<TResult>(DbDataReader) Translate<TResult>(DbDataReader)

Converte um DbDataReader existente em objetos.Converts an existing DbDataReader to objects.

Aplica-se a