ObjectContext Clase

Definición

Espacio de nombres:

System.Data.Objects

Ensamblado:

System.Data.Entity.dll

Proporciona funciones para consultar y trabajar con datos de entidad como objetos.

public ref class ObjectContext : IDisposable

public class ObjectContext : IDisposable

type ObjectContext = class
    interface IDisposable

Public Class ObjectContext
Implements IDisposable

Herencia

Object

ObjectContext

Implementaciones

IDisposable

Ejemplos

En este ejemplo se muestra cómo construir un ObjectContext.

// Create the ObjectContext.
ObjectContext context =
    new ObjectContext("name=AdventureWorksEntities");

// Set the DefaultContainerName for the ObjectContext.
// When DefaultContainerName is set, the Entity Framework only
// searches for the type in the specified container.
// Note that if a type is defined only once in the metadata workspace
// you do not have to set the DefaultContainerName.
context.DefaultContainerName = "AdventureWorksEntities";

ObjectSet<Product> query = context.CreateObjectSet<Product>();

// Iterate through the collection of Products.
foreach (Product result in query)
    Console.WriteLine("Product Name: {0}", result.Name);

Comentarios

Nota:

La clase ObjectContext no es segura para la ejecución de subprocesos. La integridad de los objetos de datos de un ObjectContext no se puede garantizar en escenarios multiproceso.

La ObjectContext clase es la clase principal para interactuar con los datos como objetos que son instancias de tipos de entidad que se definen en un modelo conceptual. Una instancia de la clase ObjectContext encapsula lo siguiente:

• Una conexión con la base de datos, en forma de un objeto EntityConnection.

• Los metadatos que describen el modelo, en forma de un objeto MetadataWorkspace.

• Un objeto ObjectStateManager que administra los objetos almacenados en la caché.

Cuando la capa de objeto que representa un modelo conceptual se genera mediante las herramientas de Entity Data Model, la clase que representa para EntityContainer el modelo se deriva de ObjectContext.

Constructores

ObjectContext(EntityConnection)	Inicializa una nueva instancia de la clase ObjectContext con la conexión especificada. Durante la construcción, el área de trabajo de metadatos se extrae del objeto EntityConnection.
ObjectContext(EntityConnection, String)	Inicializa una nueva instancia de la clase ObjectContext con la conexión y el nombre de contenedor de entidades especificados.
ObjectContext(String)	Inicializa una nueva instancia de la clase ObjectContext con la cadena de conexión y el nombre de contenedor de entidades predeterminado especificados.
ObjectContext(String, String)	Inicializa una nueva instancia de la clase ObjectContext con la cadena de conexión y el nombre de contenedor de entidades especificados.

Propiedades

CommandTimeout	Obtiene o establece el valor de tiempo de espera, en segundos, para todas las operaciones del contexto del objeto. El valor null indica que se usará el valor predeterminado del proveedor subyacente.
Connection	Obtiene la conexión usada por el contexto del objeto.
ContextOptions	Obtiene la instancia de ObjectContextOptions que contiene opciones que afectan al comportamiento de ObjectContext.
DefaultContainerName	Obtiene o establece el nombre del contenedor predeterminado.
MetadataWorkspace	Obtiene el área de trabajo de metadatos usada por el contexto del objeto.
ObjectStateManager	Obtiene el administrador de estados de objetos usado por el contexto del objeto para realizar el seguimiento de los cambios en los objetos.
QueryProvider	Obtiene el proveedor de consultas LINQ asociado a este contexto del objeto.

Métodos

AcceptAllChanges()	Acepta todos los cambios realizados en los objetos del contexto del objeto.
AddObject(String, Object)	Agrega un objeto al contexto del objeto.
ApplyCurrentValues<TEntity>(String, TEntity)	Copia los valores escalares del objeto proporcionado al objeto de ObjectContext que tiene la misma clave.
ApplyOriginalValues<TEntity>(String, TEntity)	Toma los valores escalares del objeto proporcionado y los copia en el conjunto de valores originales para el objeto del ObjectContext que tiene la misma clave.
ApplyPropertyChanges(String, Object)	Obsoletos. Aplica los cambios de propiedades de un objeto desasociado a un objeto ya asociado al contexto del objeto.
Attach(IEntityWithKey)	Asocia un objeto o un gráfico de objetos al contexto del objeto cuando el objeto tiene una clave de entidad.
AttachTo(String, Object)	Asocia un objeto o un gráfico de objetos al contexto del objeto de un conjunto de entidades determinado.
CreateDatabase()	Crea la base de datos usando la conexión del origen de datos actual y los metadatos de StoreItemCollection.
CreateDatabaseScript()	Genera un script del lenguaje de definición de datos (DDL) que crea objetos de esquema (tablas, claves principales, claves externas) para los metadatos de StoreItemCollection. StoreItemCollection carga los metadatos de los archivos del lenguaje de definición de esquemas de almacenamiento (SSDL, Store Schema Definition Language).
CreateEntityKey(String, Object)	Crea la clave de entidad para un objeto determinado o devuelve la clave de entidad si ya existe.
CreateObject<T>()	Crea y devuelve una instancia del tipo solicitado.
CreateObjectSet<TEntity>()	Crea una nueva instancia de ObjectSet<TEntity> que se usa para consultar, agregar, modificar y eliminar objetos del tipo de entidad especificado.
CreateObjectSet<TEntity>(String)	Crea una nueva instancia de ObjectSet<TEntity> que se usa para consultar, agregar, modificar y eliminar objetos del tipo especificado y con el nombre del conjunto de entidades indicado.
CreateProxyTypes(IEnumerable<Type>)	Genera un tipo equivalente que se puede usar con Entity Framework para cada tipo de la enumeración proporcionada.
CreateQuery<T>(String, ObjectParameter[])	Crea una ObjectQuery<T> en el contexto del objeto actual usando la cadena de consulta especificada.
DatabaseExists()	Comprueba si la base de datos que se especifica como la base de datos en la conexión del origen de datos actual existe en el origen de datos.
DeleteDatabase()	Elimina la base de datos que se especifica como base de datos en la conexión del origen de datos actual.
DeleteObject(Object)	Marca un objeto para su eliminación.
Detach(Object)	Quita el objeto del contexto del objeto.
DetectChanges()	Garantiza que los cambios de ObjectStateEntry se sincronizan con los cambios en todos los objetos de los que ObjectStateManager realiza un seguimiento.
Dispose()	Libera los recursos usados por el contexto del objeto.
Dispose(Boolean)	Libera los recursos usados por el contexto del objeto.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ExecuteFunction(String, ObjectParameter[])	Ejecuta un procedimiento almacenado o una función que se define en el origen de datos y se expresa en el modelo conceptual, descarta cualquier resultado devuelto de la función y devuelve el número de filas afectadas por la ejecución.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])	Ejecuta la función o el procedimiento almacenado especificado que se define en el origen de datos y se expresa en el modelo conceptual, con los parámetros y la opción de combinación especificados. Devuelve un objeto ObjectResult<T> con tipo.
ExecuteFunction<TElement>(String, ObjectParameter[])	Ejecuta un procedimiento almacenado o una función que se define en el origen de datos y se asigna en el modelo conceptual, con los parámetros especificados. Devuelve un objeto ObjectResult<T> con tipo.
ExecuteStoreCommand(String, Object[])	Ejecuta un comando arbitrario directamente en el origen de datos usando la conexión existente.
ExecuteStoreQuery<TElement>(String, Object[])	Ejecuta una consulta directamente con el origen de datos que devuelve una secuencia de resultados con tipo.
ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[])	Ejecuta una consulta directamente con el origen de datos y devuelve una secuencia de resultados con tipo. Especifique el conjunto de entidades y la opción de combinación para que se pueda realizar el seguimiento de los resultados de la consulta como entidades.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetKnownProxyTypes()	Devuelve todos los tipos de proxy existentes.
GetObjectByKey(EntityKey)	Devuelve un objeto que tiene la clave de entidad especificada.
GetObjectType(Type)	Devuelve el tipo de la entidad POCO asociada a un objeto proxy de un tipo especificado.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
LoadProperty(Object, String)	Carga explícitamente un objeto relacionado con el objeto proporcionado por la propiedad de navegación especificada y usando la opción de combinación predeterminada.
LoadProperty(Object, String, MergeOption)	Carga explícitamente un objeto relacionado con el objeto proporcionado por la propiedad de navegación especificada y usando la opción de combinación indicada.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Carga explícitamente un objeto relacionado con el objeto proporcionado por la consulta LINQ especificada y usando la opción de combinación predeterminada.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Carga explícitamente un objeto relacionado con el objeto proporcionado por la consulta LINQ especificada y usando la opción de combinación indicada.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Refresh(RefreshMode, IEnumerable)	Actualiza una colección de objetos en el contexto del objeto con datos procedentes del origen de datos.
Refresh(RefreshMode, Object)	Actualiza un objeto en el contexto del objeto con datos procedentes del origen de datos.
SaveChanges()	Conserva todas las actualizaciones en el origen de datos y restablece el seguimiento de cambios en el contexto del objeto.
SaveChanges(Boolean)	Obsoletos. Conserva todas las actualizaciones en el origen de datos y, opcionalmente, restablece el seguimiento de cambios en el contexto del objeto.
SaveChanges(SaveOptions)	Conserva todas las actualizaciones al origen de datos con el SaveOptions especificado.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Translate<TElement>(DbDataReader)	Convierte un objeto DbDataReader que contiene filas de datos de entidad en objetos del tipo de entidad solicitado.
Translate<TEntity>(DbDataReader, String, MergeOption)	Convierte un DbDataReader que contiene filas de datos de entidad en objetos del tipo de entidad solicitado, en un conjunto de entidades concreto, y con la opción de combinación especificada.
TryGetObjectByKey(EntityKey, Object)	Devuelve un objeto que tiene la clave de entidad especificada.

Eventos

ObjectMaterialized	Se produce cuando se crea un nuevo objeto entidad a partir de datos del origen de datos como parte de una operación de consulta o de carga.
SavingChanges	Se produce cuando se guardan cambios en el origen de datos.

Consulte también

• Consultar datos como objetos (Entity Framework)
• Trabajar con objetos (Entity Framework)