ObjectContext Classe

Référence

Définition

Espace de noms:: System.Data.Objects

Assembly:: System.Data.Entity.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Procure des fonctionnalités permettant d'interroger et d'utiliser des données d'entités 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 vous 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

Notes

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

La ObjectContext classe est la classe principale pour interagir avec des 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 classe ObjectContext renferme les éléments suivants :

Une connexion à la base de données, sous la forme d'un objet EntityConnection.
Les métadonnées qui décrivent le modèle, sous la forme d'un objet MetadataWorkspace.
Un objet ObjectStateManager qui gère les objets rendus persistants 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 pour le modèle est dérivée de .ObjectContext

Constructeurs

ObjectContext(EntityConnection)	Initialise une nouvelle instance de la classe ObjectContext avec la connexion donnée. Pendant la construction, l'espace de travail des métadonnées est extrait de l'objet EntityConnection.
ObjectContext(EntityConnection, String)	Initialise une nouvelle instance de la classe ObjectContext avec une connexion et un nom de conteneur d'entités donnés.
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.
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.

Propriétés

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

Méthodes

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 du ObjectContext qui a la même clé.
ApplyOriginalValues<TEntity>(String, TEntity)	Copie les valeurs scalaires de l'objet fourni dans le jeu de valeurs d'origine de l'objet dans le ObjectContext qui a 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 objet ou graphique d'objet au contexte de l'objet lorsque l'objet a une clé d'entité.
AttachTo(String, Object)	Attache un objet ou graphique d'objet au contexte de l'objet dans un jeu d'entités spécifique.
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.
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. La classe StoreItemCollection charge les 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é si elle existe déjà.
CreateObject<T>()	Crée et retourne une instance du type demandé.
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é.
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é.
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.
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.
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.
DeleteDatabase()	Supprime la base de données spécifiée comme base de données dans la connexion à la source de données actuelle.
DeleteObject(Object)	Marque un objet pour la suppression.
Detach(Object)	Supprime l'objet du contexte de l'objet.
DetectChanges()	Garantit que les modifications de ObjectStateEntry sont synchronisées avec celles de tous les objets suivis par 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 égal à l'objet actuel. (Hérité de Object)
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.
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. Retourne un ObjectResult<T> typé.
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. Retourne un ObjectResult<T> typé.
ExecuteStoreCommand(String, Object[])	Exécute directement une commande arbitraire sur la source de données à l'aide de la connexion existante.
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.
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. 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.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetKnownProxyTypes()	Retourne tous les types de proxies 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 du type spécifié.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
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.
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.
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.
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.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (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()	Rend toutes les mises à jour persistantes dans la source de données et réinitialise le suivi des modifications dans le contexte de l'objet.
SaveChanges(Boolean)	Obsolète. Rend toutes les mises à jour persistantes dans la source de données et réinitialise éventuellement le suivi des modifications dans le contexte de l'objet.
SaveChanges(SaveOptions)	Rend persistantes toutes les mises à jour de la source de données avec le SaveOptions spécifié.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
Translate<TElement>(DbDataReader)	Traduit un DbDataReader qui contient des lignes de données d'entité en objets du type d'entité demandé.
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.
TryGetObjectByKey(EntityKey, Object)	Retourne un objet qui a la clé d'entité spécifiée.

Événements

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.
SavingChanges	Se produit lorsque des modifications sont enregistrées dans la source de données.

S’applique à

Partager via