ObjectContext Classe

Définition

Espace de noms:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Fournit des fonctionnalités permettant d’interroger et d’utiliser des données d’entité en tant qu’objets.

public ref class ObjectContext : IDisposable

public class ObjectContext : IDisposable

type ObjectContext = class
    interface IDisposable

Public Class ObjectContext
Implements IDisposable

Héritage

Object

ObjectContext

Implémente

IDisposable

Exemples

Cet exemple montre comment construire 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);

Remarques

Note

La classe ObjectContext n'est pas thread-safe. L’intégrité des objets de données dans un scénario ObjectContext multithread ne peut pas être garantie.

La ObjectContext classe est la classe principale pour interagir avec les données en tant qu’objets qui sont des instances de types d’entités définis dans un modèle conceptuel. Une instance de la ObjectContext classe encapsule les éléments suivants :

• Connexion à la base de données, sous la forme d’un EntityConnection objet.

• Métadonnées qui décrivent le modèle, sous la forme d’un MetadataWorkspace objet.

• Objet ObjectStateManager qui gère les objets conservés dans le cache.

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 modèle est dérivée de l’objet ObjectContext.

Constructeurs

Nom	Description
ObjectContext(EntityConnection, String)	Initialise une nouvelle instance de la ObjectContext classe avec un nom de conteneur de connexion et d’entité donné.
ObjectContext(EntityConnection)	Initialise une nouvelle instance de la ObjectContext classe avec la connexion donnée. Pendant la construction, l’espace de travail de métadonnées est extrait de l’objet EntityConnection .
ObjectContext(String, String)	Initialise une nouvelle instance de la classe ObjectContext avec un nom de conteneur d’entités et de chaîne de connexion donné.
ObjectContext(String)	Initialise une nouvelle instance de la classe ObjectContext avec le nom de conteneur d’entités chaîne de connexion et par défaut donnés.

Propriétés

Nom	Description
CommandTimeout	Obtient ou définit la valeur de délai d’expiration, en secondes, pour toutes les opérations de contexte d’objet. Une null valeur indique que la valeur par défaut du fournisseur sous-jacent sera utilisée.
Connection	Obtient la connexion utilisée par le contexte d’objet.
ContextOptions	Obtient l’instance ObjectContextOptions qui contient des options qui affectent le comportement du ObjectContext.
DefaultContainerName	Obtient ou définit le nom du conteneur par défaut.
MetadataWorkspace	Obtient l’espace de travail de métadonnées utilisé par le contexte de l’objet.
ObjectStateManager	Obtient le gestionnaire d’état d’objet utilisé par le contexte d’objet pour suivre les modifications d’objet.
QueryProvider	Obtient le fournisseur de requêtes LINQ associé à ce contexte d’objet.

Méthodes

Nom	Description
AcceptAllChanges()	Accepte toutes les modifications apportées aux objets dans le contexte de l’objet.
AddObject(String, Object)	Ajoute un objet au contexte de l’objet.
ApplyCurrentValues<TEntity>(String, TEntity)	Copie les valeurs scalaires de l’objet fourni dans l’objet dans lequel se trouve la ObjectContext même clé.
ApplyOriginalValues<TEntity>(String, TEntity)	Copie les valeurs scalaires de l’objet fourni dans un ensemble de valeurs d’origine pour l’objet dans lequel ObjectContext se trouve la même clé.
ApplyPropertyChanges(String, Object)	Obsolète. Applique les modifications de propriété d’un objet détaché à un objet déjà attaché au contexte de l’objet.
Attach(IEntityWithKey)	Attache un graphique d’objet ou d’objet au contexte de l’objet lorsque l’objet a une clé d’entité.
AttachTo(String, Object)	Attache un graphique d’objet ou d’objet au contexte d’objet dans un jeu d’entités spécifique.
CreateDatabase()	Crée la base de données à l’aide de la connexion de source de données actuelle et des métadonnées dans le StoreItemCollection.
CreateDatabaseScript()	Génère un script DDL (Data Definition Language) qui crée des objets de schéma (tables, clés primaires, clés étrangères) pour les métadonnées dans le StoreItemCollection. Charge les StoreItemCollection métadonnées à partir de fichiers SSDL (Store Schema Definition Language).
CreateEntityKey(String, Object)	Crée la clé d’entité pour un objet spécifique ou retourne la clé d’entité s’il existe déjà.
CreateObject<T>()	Crée et retourne une instance du type demandé.
CreateObjectSet<TEntity>()	Crée une ObjectSet<TEntity> instance utilisée pour interroger, ajouter, modifier et supprimer des objets du type d’entité spécifié.
CreateObjectSet<TEntity>(String)	Crée une ObjectSet<TEntity> instance utilisée pour interroger, ajouter, modifier et supprimer des objets du type spécifié et avec le nom du jeu d’entités spécifié.
CreateProxyTypes(IEnumerable<Type>)	Génère un type équivalent qui peut être utilisé avec Entity Framework pour chaque type de l’énumération fournie.
CreateQuery<T>(String, ObjectParameter[])	Crée un ObjectQuery<T> contexte d’objet actuel à l’aide de la chaîne de requête spécifiée.
DatabaseExists()	Vérifie si la base de données spécifiée comme base de données dans la connexion de source de données actuelle existe sur la source de données.
DeleteDatabase()	Supprime la base de données spécifiée comme base de données dans la connexion de source de données actuelle.
DeleteObject(Object)	Marque un objet à supprimer.
Detach(Object)	Supprime l’objet du contexte de l’objet.
DetectChanges()	Garantit que ObjectStateEntry les modifications sont synchronisées avec les modifications de tous les objets suivis par le ObjectStateManager.
Dispose()	Libère les ressources utilisées par le contexte de l’objet.
Dispose(Boolean)	Libère les ressources utilisées par le contexte de l’objet.
Equals(Object)	Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object)
ExecuteFunction(String, ObjectParameter[])	Exécute une procédure stockée ou une fonction 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 ; retourne le nombre de lignes affectées par l’exécution.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])	Exécute la procédure stockée ou la fonction donnée définie dans la source de données et exprimée dans le modèle conceptuel, avec les paramètres spécifiés et l’option de fusion. Retourne un type ObjectResult<T>.
ExecuteFunction<TElement>(String, ObjectParameter[])	Exécute une procédure stockée ou une fonction définie dans la source de données et mappée dans le modèle conceptuel, avec les paramètres spécifiés. Retourne un type ObjectResult<T>.
ExecuteStoreCommand(String, Object[])	Exécute une commande arbitraire directement sur la source de données à l’aide de la connexion existante.
ExecuteStoreQuery<TElement>(String, Object[])	Exécute une requête directement sur la source de données qui retourne une séquence de résultats typés.
ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[])	Exécute une requête directement sur la source de données et retourne une séquence de résultats typés. Spécifiez le jeu d’entités et l’option de fusion afin que les résultats de la requête puissent être suivis en tant qu’entités.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetKnownProxyTypes()	Retourne tous les types de proxy existants.
GetObjectByKey(EntityKey)	Retourne un objet qui a la clé d’entité spécifiée.
GetObjectType(Type)	Retourne le type d’entité de l’entité POCO associée à un objet proxy d’un type spécifié.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
LoadProperty(Object, String, MergeOption)	Charge explicitement un objet lié à l’objet fourni par la propriété de navigation spécifiée et à l’aide de l’option de fusion spécifiée.
LoadProperty(Object, String)	Charge explicitement un objet lié à l’objet fourni par la propriété de navigation spécifiée et à l’aide de l’option de fusion par défaut.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Charge explicitement un objet lié à l’objet fourni par la requête LINQ spécifiée et à l’aide de l’option de fusion spécifiée.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Charge explicitement un objet lié à l’objet fourni par la requête LINQ spécifiée et à l’aide de l’option de fusion par défaut.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
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.
Refresh(RefreshMode, Object)	Met à jour un objet dans le contexte de l’objet avec des données de la source de données.
SaveChanges()	Conserve toutes les mises à jour de la source de données et réinitialise le suivi des modifications dans le contexte de l’objet.
SaveChanges(Boolean)	Obsolète. Conserve toutes les mises à jour de la source de données et réinitialise éventuellement le suivi des modifications dans le contexte de l’objet.
SaveChanges(SaveOptions)	Conserve toutes les mises à jour de la source de données avec le fichier spécifié SaveOptions.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
Translate<TElement>(DbDataReader)	Traduit une DbDataReader ligne contenant des lignes de données d’entité en objets du type d’entité demandé.
Translate<TEntity>(DbDataReader, String, MergeOption)	Convertit une DbDataReader ligne 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 spécifiée.
TryGetObjectByKey(EntityKey, Object)	Retourne un objet qui a la clé d’entité spécifiée.

Événements

Nom	Description
ObjectMaterialized	Se produit lorsqu’un nouvel objet d’entité est créé à partir de données dans la source de données dans le cadre d’une opération de requête ou de chargement.
SavingChanges	Se produit lorsque les modifications sont enregistrées dans la source de données.

Voir aussi

• Interrogation de données en tant qu’objets (Entity Framework)
• Utilisation d’objets (Entity Framework)