ObjectContext Clase

Definición

Proporciona instalaciones 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
ObjectContext
Implementaciones

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 datos como objetos que son instancias de tipos de entidad definidos en un modelo conceptual. Una instancia de la ObjectContext clase encapsula lo siguiente:

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

Constructores

Nombre Description
ObjectContext(EntityConnection, String)

Inicializa una nueva instancia de la ObjectContext clase con un nombre de contenedor de entidad y conexión determinado.

ObjectContext(EntityConnection)

Inicializa una nueva instancia de la ObjectContext clase con la conexión especificada. Durante la construcción, el área de trabajo de metadatos se extrae del EntityConnection objeto .

ObjectContext(String, String)

Inicializa una nueva instancia de la clase /> de

ObjectContext(String)

Inicializa una nueva instancia de la clase ObjectContext con el cadena de conexión especificado y el nombre de contenedor de entidad predeterminado.

Propiedades

Nombre Description
CommandTimeout

Obtiene o establece el valor de tiempo de espera, en segundos, para todas las operaciones de contexto de objeto. Un null valor indica que se usará el valor predeterminado del proveedor subyacente.

Connection

Obtiene la conexión utilizada por el contexto del objeto.

ContextOptions

Obtiene la ObjectContextOptions instancia de que contiene opciones que afectan al comportamiento de ObjectContext.

DefaultContainerName

Obtiene o establece el nombre de contenedor predeterminado.

MetadataWorkspace

Obtiene el área de trabajo de metadatos usada por el contexto del objeto.

ObjectStateManager

Obtiene el administrador de estado de objeto utilizado por el contexto del objeto para realizar un seguimiento de los cambios de objeto.

QueryProvider

Obtiene el proveedor de consultas LINQ asociado a este contexto de objeto.

Métodos

Nombre Description
AcceptAllChanges()

Acepta todos los cambios realizados en objetos en el contexto del objeto.

AddObject(String, Object)

Agrega un objeto al contexto del objeto.

ApplyCurrentValues<TEntity>(String, TEntity)

Copia los valores escalares del objeto proporcionado en el objeto de que ObjectContext tiene la misma clave.

ApplyOriginalValues<TEntity>(String, TEntity)

Copia los valores escalares del objeto proporcionado en un conjunto de valores originales para el objeto de que ObjectContext tiene la misma clave.

ApplyPropertyChanges(String, Object)
Obsoletos.

Aplica los cambios de propiedad de un objeto desasociado a un objeto ya asociado al contexto del objeto.

Attach(IEntityWithKey)

Asocia un objeto o gráfico de objetos al contexto del objeto cuando el objeto tiene una clave de entidad.

AttachTo(String, Object)

Asocia un gráfico de objetos u objetos al contexto de objeto de un conjunto de entidades específico.

CreateDatabase()

Crea la base de datos mediante la conexión del origen de datos actual y los metadatos de StoreItemCollection.

CreateDatabaseScript()

Genera un script de lenguaje de definición de datos (DDL) que crea objetos de esquema (tablas, claves principales, claves externas) para los metadatos de StoreItemCollection. Carga StoreItemCollection los metadatos de los archivos del lenguaje de definición de esquema (SSDL) del almacén.

CreateEntityKey(String, Object)

Crea la clave de entidad para un objeto específico o devuelve la clave de entidad si ya existe.

CreateObject<T>()

Crea y devuelve una instancia del tipo solicitado .

CreateObjectSet<TEntity>()

Crea una nueva ObjectSet<TEntity> instancia que se usa para consultar, agregar, modificar y eliminar objetos del tipo de entidad especificado.

CreateObjectSet<TEntity>(String)

Crea una nueva ObjectSet<TEntity> instancia que se usa para consultar, agregar, modificar y eliminar objetos del tipo especificado y con el nombre del conjunto de entidades especificado.

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 un ObjectQuery<T> objeto en el contexto de objeto actual mediante la cadena de consulta especificada.

DatabaseExists()

Comprueba si la base de datos especificada como base de datos de la conexión del origen de datos actual existe en el origen de datos.

DeleteDatabase()

Elimina la base de datos especificada 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 ObjectStateEntry los cambios se sincronicen con los cambios de todos los objetos a los que realiza el seguimiento .ObjectStateManager

Dispose()

Libera los recursos utilizados por el contexto del objeto.

Dispose(Boolean)

Libera los recursos utilizados 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 los resultados devueltos de la función; y devuelve el número de filas afectadas por la ejecución.

ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

Ejecuta el procedimiento almacenado o la función especificados que se definen en el origen de datos y se expresan en el modelo conceptual, con los parámetros especificados y la opción de combinación. Devuelve un objeto con ObjectResult<T>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 con ObjectResult<T>tipo .

ExecuteStoreCommand(String, Object[])

Ejecuta un comando arbitrario directamente en el origen de datos mediante la conexión existente.

ExecuteStoreQuery<TElement>(String, Object[])

Ejecuta una consulta directamente en el origen de datos que devuelve una secuencia de resultados con tipo.

ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[])

Ejecuta una consulta directamente en 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 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 entidad 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, MergeOption)

Carga explícitamente un objeto relacionado con el objeto proporcionado por la propiedad de navegación especificada y utilizando la opción de combinación especificada.

LoadProperty(Object, String)

Carga explícitamente un objeto relacionado con el objeto proporcionado por la propiedad de navegación especificada y utilizando 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 mediante la opción de combinación especificada.

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)

Carga explícitamente un objeto relacionado con el objeto proporcionado por la consulta LINQ especificada y mediante la opción de combinación predeterminada.

MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
Refresh(RefreshMode, IEnumerable)

Actualiza una colección de objetos en el contexto del objeto con datos del origen de datos.

Refresh(RefreshMode, Object)

Actualiza un objeto en el contexto del objeto con datos del origen de datos.

SaveChanges()

Conserva todas las actualizaciones del origen de datos y restablece el seguimiento de cambios en el contexto del objeto.

SaveChanges(Boolean)
Obsoletos.

Conserva todas las actualizaciones del origen de datos y, opcionalmente, restablece el seguimiento de cambios en el contexto del objeto.

SaveChanges(SaveOptions)

Conserva todas las actualizaciones del origen de datos con el especificado SaveOptions.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
Translate<TElement>(DbDataReader)

Traduce un DbDataReader objeto que contiene filas de datos de entidad a objetos del tipo de entidad solicitado.

Translate<TEntity>(DbDataReader, String, MergeOption)

Traduce un DbDataReader objeto que contiene filas de datos de entidad a objetos del tipo de entidad solicitado, en un conjunto de entidades específico y con la opción de combinación especificada.

TryGetObjectByKey(EntityKey, Object)

Devuelve un objeto que tiene la clave de entidad especificada.

Eventos

Nombre Description
ObjectMaterialized

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

SavingChanges

Se produce cuando los cambios se guardan en el origen de datos.

Se aplica a

Consulte también