ObjectContext ObjectContext ObjectContext ObjectContext Class

Définition

Fournit des fonctionnalités permettant d'interroger et d'utiliser des données d'entité en tant qu'objets.Provides facilities for querying and working with entity data as objects.

public ref class ObjectContext : IDisposable
public class ObjectContext : IDisposable
type ObjectContext = class
    interface IDisposable
Public Class ObjectContext
Implements IDisposable
Héritage
ObjectContextObjectContextObjectContextObjectContext
Implémente

Exemples

Cet exemple est basé sur le modèle de vente AdventureWorks Sales Model.This example is based on the AdventureWorks Sales Model. L'exemple montre comment construire un objet ObjectContext.The example shows you how to construct an 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);
' Create the ObjectContext. 
Dim context As 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"

Dim query As ObjectSet(Of Product) = context.CreateObjectSet(Of Product)()

' Iterate through the collection of Products. 
For Each result As Product In query
    Console.WriteLine("Product Name: {0}", result.Name)
Next

Remarques

Notes

La classe ObjectContext n'est pas thread-safe.The ObjectContext class is not thread safe. L’intégrité des objets de données dans ObjectContext un ne peut pas être garantie dans les scénarios multithread.The integrity of data objects in an ObjectContext cannot be ensured in multithreaded scenarios.

La ObjectContext classe est la classe principale pour l’interaction avec les données en tant qu’objets qui sont des instances de types d’entité définis dans un modèle conceptuel.The ObjectContext class is the primary class for interacting with data as objects that are instances of entity types that are defined in a conceptual model. Une instance de la classe ObjectContext renferme les éléments suivants :An instance of the ObjectContext class encapsulates the following:

Lorsque la couche objet qui représente un modèle conceptuel est générée par les outils Entity Data Model, la classe qui représente le EntityContainer pour le modèle est dérivée ObjectContextde.When the object layer that represents a conceptual model is generated by the Entity Data Model tools, the class that represents the EntityContainer for the model is derived from the ObjectContext.

Constructeurs

ObjectContext(EntityConnection) ObjectContext(EntityConnection) ObjectContext(EntityConnection) ObjectContext(EntityConnection)

Initialise une nouvelle instance de la classe ObjectContext avec la connexion donnée.Initializes a new instance of the ObjectContext class with the given connection. Pendant la construction, l'espace de travail des métadonnées est extrait de l'objet EntityConnection.During construction, the metadata workspace is extracted from the EntityConnection object.

ObjectContext(EntityConnection, String) ObjectContext(EntityConnection, String) ObjectContext(EntityConnection, String) ObjectContext(EntityConnection, String)

Initialise une nouvelle instance de la classe ObjectContext avec une connexion et un nom de conteneur d'entités donnés.Initializes a new instance of the ObjectContext class with a given connection and entity container name.

ObjectContext(String) ObjectContext(String) ObjectContext(String) ObjectContext(String)

Initialise une nouvelle instance de la classe ObjectContext avec la chaîne de connexion donnée et le nom de conteneur d'entités par défaut.Initializes a new instance of the ObjectContext class with the given connection string and default entity container name.

ObjectContext(String, String) ObjectContext(String, String) ObjectContext(String, String) ObjectContext(String, String)

Initialise une nouvelle instance de la classe ObjectContext avec une chaîne de connexion et un nom de conteneur d'entités donnés.Initializes a new instance of the ObjectContext class with a given connection string and entity container name.

Propriétés

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

Obtient ou définit la valeur de délai d'attente, en secondes, pour toutes les opérations exécutées dans le contexte de l'objet.Gets or sets the timeout value, in seconds, for all object context operations. Une valeur null indique que la valeur par défaut du fournisseur sous-jacent sera utilisée.A null value indicates that the default value of the underlying provider will be used.

Connection Connection Connection Connection

Obtient la connexion utilisée par le contexte de l'objet.Gets the connection used by the object context.

ContextOptions ContextOptions ContextOptions ContextOptions

Obtient l'instance de ObjectContextOptions qui contient les options affectant le comportement de ObjectContext.Gets the ObjectContextOptions instance that contains options that affect the behavior of the ObjectContext.

DefaultContainerName DefaultContainerName DefaultContainerName DefaultContainerName

Obtient ou définit le nom du conteneur par défaut.Gets or sets the default container name.

MetadataWorkspace MetadataWorkspace MetadataWorkspace MetadataWorkspace

Obtient l'espace de travail des métadonnées qui est utilisé par le contexte de l'objet.Gets the metadata workspace used by the object context.

ObjectStateManager ObjectStateManager ObjectStateManager ObjectStateManager

Obtient le gestionnaire d'état d'objet qui est utilisé par le contexte de l'objet pour assurer le suivi des modifications d'objets.Gets the object state manager used by the object context to track object changes.

QueryProvider QueryProvider QueryProvider QueryProvider

Obtient le fournisseur de requête LINQ associé à ce contexte d'objet.Gets the LINQ query provider associated with this object context.

Méthodes

AcceptAllChanges() AcceptAllChanges() AcceptAllChanges() AcceptAllChanges()

Accepte toutes les modifications apportées aux objets dans le contexte de l'objet.Accepts all changes made to objects in the object context.

AddObject(String, Object) AddObject(String, Object) AddObject(String, Object) AddObject(String, Object)

Ajoute un objet au contexte de l'objet.Adds an object to the object context.

ApplyCurrentValues<TEntity>(String, TEntity) ApplyCurrentValues<TEntity>(String, TEntity) ApplyCurrentValues<TEntity>(String, TEntity) ApplyCurrentValues<TEntity>(String, TEntity)

Copie les valeurs scalaires de l'objet fourni dans l'objet du ObjectContext qui a la même clé.Copies the scalar values from the supplied object into the object in the ObjectContext that has the same key.

ApplyOriginalValues<TEntity>(String, TEntity) ApplyOriginalValues<TEntity>(String, TEntity) ApplyOriginalValues<TEntity>(String, TEntity) ApplyOriginalValues<TEntity>(String, TEntity)

Copie les valeurs scalaires de l'objet fourni dans le jeu des valeurs d'origine pour l'objet du ObjectContext qui a la même clé.Copies the scalar values from the supplied object into set of original values for the object in the ObjectContext that has the same key.

ApplyPropertyChanges(String, Object) ApplyPropertyChanges(String, Object) ApplyPropertyChanges(String, Object) ApplyPropertyChanges(String, Object)

Applique les modifications de propriétés d'un objet détaché à un objet déjà attaché au contexte de l'objet.Applies property changes from a detached object to an object already attached to the object context.

Attach(IEntityWithKey) Attach(IEntityWithKey) Attach(IEntityWithKey) Attach(IEntityWithKey)

Attache un objet ou graphique d'objet au contexte de l'objet lorsque l'objet a une clé d'entité.Attaches an object or object graph to the object context when the object has an entity key.

AttachTo(String, Object) AttachTo(String, Object) AttachTo(String, Object) AttachTo(String, Object)

Attache un objet ou graphique d'objet au contexte de l'objet dans un jeu d'entités spécifique.Attaches an object or object graph to the object context in a specific entity set.

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

Crée la base de données en utilisant la connexion à la source de données actuelle et les métadonnées de StoreItemCollection.Creates the database by using the current data source connection and the metadata in the StoreItemCollection.

CreateDatabaseScript() CreateDatabaseScript() CreateDatabaseScript() CreateDatabaseScript()

Génère un script de langage de définition de données (DDL) qui crée des objets de schéma (tables, clés primaires, clés étrangères) pour les métadonnées de StoreItemCollection.Generates a data definition language (DDL) script that creates schema objects (tables, primary keys, foreign keys) for the metadata in the StoreItemCollection. La classe StoreItemCollection charge les métadonnées à partir de fichiers SSDL (Store Schema Definition Language).The StoreItemCollection loads metadata from store schema definition language (SSDL) files.

CreateEntityKey(String, Object) CreateEntityKey(String, Object) CreateEntityKey(String, Object) CreateEntityKey(String, Object)

Crée la clé d'entité d'un objet spécifique ou retourne la clé d'entité si elle existe déjà.Creates the entity key for a specific object, or returns the entity key if it already exists.

CreateObject<T>() CreateObject<T>() CreateObject<T>() CreateObject<T>()

Crée et retourne une instance du type demandé.Creates and returns an instance of the requested type .

CreateObjectSet<TEntity>() CreateObjectSet<TEntity>() CreateObjectSet<TEntity>() CreateObjectSet<TEntity>()

Crée une nouvelle instance de ObjectSet<TEntity> qui est utilisée pour interroger, ajouter, modifier et supprimer des objets du type d'entité spécifié.Creates a new ObjectSet<TEntity> instance that is used to query, add, modify, and delete objects of the specified entity type.

CreateObjectSet<TEntity>(String) CreateObjectSet<TEntity>(String) CreateObjectSet<TEntity>(String) CreateObjectSet<TEntity>(String)

Crée une nouvelle instance de ObjectSet<TEntity> qui est utilisée pour interroger, ajouter, modifier et supprimer des objets du type spécifié, portant le nom de jeu d'entité indiqué.Creates a new ObjectSet<TEntity> instance that is used to query, add, modify, and delete objects of the specified type and with the specified entity set name.

CreateProxyTypes(IEnumerable<Type>) CreateProxyTypes(IEnumerable<Type>) CreateProxyTypes(IEnumerable<Type>) CreateProxyTypes(IEnumerable<Type>)

Génère un type équivalent qui peut être utilisé avec l'Entity Framework pour chaque type de l'énumération fournie.Generates an equivalent type that can be used with the Entity Framework for each type in the supplied enumeration.

CreateQuery<T>(String, ObjectParameter[]) CreateQuery<T>(String, ObjectParameter[]) CreateQuery<T>(String, ObjectParameter[]) CreateQuery<T>(String, ObjectParameter[])

Crée un objet ObjectQuery<T> dans le contexte de l'objet actuel à l'aide de la chaîne de requête spécifiée.Creates an ObjectQuery<T> in the current object context by using the specified query string.

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

Vérifie si la base de données spécifiée comme base de données dans la connexion à la source de données actuelle existe sur la source de données.Checks if the database that is specified as the database in the current data source connection exists on the data source.

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

Supprime la base de données spécifiée comme base de données dans la connexion à la source de données actuelle.Deletes the database that is specified as the database in the current data source connection.

DeleteObject(Object) DeleteObject(Object) DeleteObject(Object) DeleteObject(Object)

Marque un objet pour la suppression.Marks an object for deletion.

Detach(Object) Detach(Object) Detach(Object) Detach(Object)

Supprime l'objet du contexte de l'objet.Removes the object from the object context.

DetectChanges() DetectChanges() DetectChanges() DetectChanges()

Garantit que les modifications de ObjectStateEntry sont synchronisées avec celles de tous les objets suivis par ObjectStateManager.Ensures that ObjectStateEntry changes are synchronized with changes in all objects that are tracked by the ObjectStateManager.

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

Libère les ressources utilisées par le contexte de l'objet.Releases the resources used by the object context.

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

Libère les ressources utilisées par le contexte de l'objet.Releases the resources used by the object context.

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

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExecuteFunction(String, ObjectParameter[]) ExecuteFunction(String, ObjectParameter[]) ExecuteFunction(String, ObjectParameter[]) ExecuteFunction(String, ObjectParameter[])

Exécute une fonction ou procédure stockée qui est définie dans la source de données et exprimée dans le modèle conceptuel, ignore les résultats retournés par la fonction et retourne le nombre de lignes affectées par l'exécution.Executes a stored procedure or function that is defined in the data source and expressed in the conceptual model; discards any results returned from the function; and returns the number of rows affected by the execution.

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

Exécute la fonction ou procédure stockée indiquée qui est définie dans la source de données et exprimée dans le modèle conceptuel, avec les paramètres et l'option de fusion spécifiés.Executes the given stored procedure or function that is defined in the data source and expressed in the conceptual model, with the specified parameters, and merge option. Retourne un ObjectResult<T> typé.Returns a typed ObjectResult<T>.

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

Exécute une fonction ou procédure stockée qui est définie dans la source de données et mappée dans le modèle conceptuel, avec les paramètres spécifiés.Executes a stored procedure or function that is defined in the data source and mapped in the conceptual model, with the specified parameters. Retourne un ObjectResult<T> typé.Returns a typed ObjectResult<T>.

ExecuteStoreCommand(String, Object[]) ExecuteStoreCommand(String, Object[]) ExecuteStoreCommand(String, Object[]) ExecuteStoreCommand(String, Object[])

Exécute directement une commande arbitraire sur la source de données à l'aide de la connexion existante.Executes an arbitrary command directly against the data source using the existing connection.

ExecuteStoreQuery<TElement>(String, Object[]) ExecuteStoreQuery<TElement>(String, Object[]) ExecuteStoreQuery<TElement>(String, Object[]) ExecuteStoreQuery<TElement>(String, Object[])

Exécute directement sur la source de données une requête qui retourne une séquence de résultats typés.Executes a query directly against the data source that returns a sequence of typed results.

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

Exécute directement une requête sur la source de données et retourne une séquence de résultats typés.Executes a query directly against the data source and returns a sequence of typed results. Spécifiez le jeu d'entités et l'option de fusion pour que les résultats de la requête puissent être suivis sous forme d'entités.Specify the entity set and the merge option so that query results can be tracked as entities.

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

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetKnownProxyTypes() GetKnownProxyTypes() GetKnownProxyTypes() GetKnownProxyTypes()

Retourne tous les types de proxies existants.Returns all the existing proxy types.

GetObjectByKey(EntityKey) GetObjectByKey(EntityKey) GetObjectByKey(EntityKey) GetObjectByKey(EntityKey)

Retourne un objet qui a la clé d'entité spécifiée.Returns an object that has the specified entity key.

GetObjectType(Type) GetObjectType(Type) GetObjectType(Type) GetObjectType(Type)

Retourne le type d'entité de l'entité POCO associée à un objet proxy du type spécifié.Returns the entity type of the POCO entity associated with a proxy object of a specified type.

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

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
LoadProperty(Object, String) LoadProperty(Object, String) LoadProperty(Object, String) LoadProperty(Object, String)

Charge explicitement, à l'aide de l'option de fusion par défaut, un objet lié à l'objet fourni par la propriété de navigation spécifiée.Explicitly loads an object related to the supplied object by the specified navigation property and using the default merge option.

LoadProperty(Object, String, MergeOption) LoadProperty(Object, String, MergeOption) LoadProperty(Object, String, MergeOption) LoadProperty(Object, String, MergeOption)

Charge explicitement, à l'aide de l'option de fusion spécifiée, un objet lié à l'objet fourni par la propriété de navigation indiquée.Explicitly loads an object that is related to the supplied object by the specified navigation property and using the specified merge option.

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

Charge explicitement, à l'aide de l'option de fusion par défaut, un objet lié à l'objet fourni par la requête LINQ spécifiée.Explicitly loads an object that is related to the supplied object by the specified LINQ query and by using the default merge option.

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

Charge explicitement, à l'aide de l'option de fusion spécifiée, un objet lié à l'objet fourni par la requête LINQ indiquée.Explicitly loads an object that is related to the supplied object by the specified LINQ query and by using the specified merge option.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

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

Met à jour une collection d'objets dans le contexte de l'objet avec des données de la source de données.Updates a collection of objects in the object context with data from the data source.

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

Met à jour un objet dans le contexte de l'objet avec des données de la source de données.Updates an object in the object context with data from the data source.

SaveChanges() SaveChanges() SaveChanges() SaveChanges()

Rend persistantes toutes les mises à jour apportées à la source de données et réinitialise le suivi des modifications dans le contexte de l'objet.Persists all updates to the data source and resets change tracking in the object context.

SaveChanges(Boolean) SaveChanges(Boolean) SaveChanges(Boolean) SaveChanges(Boolean)

Rend persistantes toutes les mises à jour apportées à la source de données et réinitialise éventuellement le suivi des modifications dans le contexte de l'objet.Persists all updates to the data source and optionally resets change tracking in the object context.

SaveChanges(SaveOptions) SaveChanges(SaveOptions) SaveChanges(SaveOptions) SaveChanges(SaveOptions)

Rend persistantes toutes les mises à jour de la source de données avec le SaveOptions spécifié.Persists all updates to the data source with the specified SaveOptions.

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

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
Translate<TElement>(DbDataReader) Translate<TElement>(DbDataReader) Translate<TElement>(DbDataReader) Translate<TElement>(DbDataReader)

Traduit un DbDataReader qui contient des lignes de données d'entité en objets du type d'entité demandé.Translates a DbDataReader that contains rows of entity data to objects of the requested entity type.

Translate<TEntity>(DbDataReader, String, MergeOption) Translate<TEntity>(DbDataReader, String, MergeOption) Translate<TEntity>(DbDataReader, String, MergeOption) Translate<TEntity>(DbDataReader, String, MergeOption)

Traduit un DbDataReader qui contient des lignes de données d'entité en objets du type d'entité demandé, dans un jeu d'entités spécifique et avec l'option de fusion indiquée.Translates a DbDataReader that contains rows of entity data to objects of the requested entity type, in a specific entity set, and with the specified merge option.

TryGetObjectByKey(EntityKey, Object) TryGetObjectByKey(EntityKey, Object) TryGetObjectByKey(EntityKey, Object) TryGetObjectByKey(EntityKey, Object)

Retourne un objet qui a la clé d'entité spécifiée.Returns an object that has the specified entity key.

Événements

ObjectMaterialized ObjectMaterialized ObjectMaterialized ObjectMaterialized

Se produit lorsqu'un nouvel objet d'entité est créé à partir des données de la source de données dans le cadre d'une requête ou d'une opération de chargement.Occurs when a new entity object is created from data in the data source as part of a query or load operation.

SavingChanges SavingChanges SavingChanges SavingChanges

Se produit lorsque des modifications sont enregistrées dans la source de données.Occurs when changes are saved to the data source.

S’applique à

Voir aussi