ObjectContext Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt faciliteiten voor het opvragen en werken met entiteitsgegevens als objecten.
public ref class ObjectContext : IDisposable
public class ObjectContext : IDisposable
type ObjectContext = class
interface IDisposable
Public Class ObjectContext
Implements IDisposable
- Overname
-
ObjectContext
- Implementeringen
Voorbeelden
In dit voorbeeld ziet u hoe u een 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);
Opmerkingen
Opmerking
De ObjectContext klasse is niet thread-veilig. De integriteit van gegevensobjecten in een ObjectContext scenario met meerdere gelezen gegevens kan niet worden gegarandeerd.
De ObjectContext klasse is de primaire klasse voor interactie met gegevens als objecten die exemplaren zijn van entiteitstypen die zijn gedefinieerd in een conceptueel model. Een exemplaar van de ObjectContext klasse bevat het volgende:
Een verbinding met de database, in de vorm van een EntityConnection object.
Metagegevens die het model beschrijven, in de vorm van een MetadataWorkspace object.
Een ObjectStateManager object waarmee objecten in de cache worden beheerd.
Wanneer de objectlaag die een conceptueel model vertegenwoordigt, wordt gegenereerd door de hulpprogramma's voor entiteitsgegevensmodel, wordt de klasse die het EntityContainer voor het model vertegenwoordigt, afgeleid van het ObjectContext.
Constructors
| Name | Description |
|---|---|
| ObjectContext(EntityConnection, String) |
Initialiseert een nieuw exemplaar van de ObjectContext klasse met een bepaalde verbindings- en entiteitscontainernaam. |
| ObjectContext(EntityConnection) |
Initialiseert een nieuw exemplaar van de ObjectContext klasse met de opgegeven verbinding. Tijdens de bouw wordt de werkruimte met metagegevens uit het EntityConnection object geëxtraheerd. |
| ObjectContext(String, String) |
Initialiseert een nieuw exemplaar van de klasse ObjectContext met een gegeven verbindingsreeks en de naam van de entiteitscontainer. |
| ObjectContext(String) |
Initialiseert een nieuw exemplaar van de klasse ObjectContext met de opgegeven verbindingsreeks en de naam van de standaardentiteitscontainer. |
Eigenschappen
| Name | Description |
|---|---|
| CommandTimeout |
Hiermee haalt u de time-outwaarde in seconden op of stelt u deze in voor alle objectcontextbewerkingen. Een |
| Connection |
Hiermee haalt u de verbinding op die wordt gebruikt door de objectcontext. |
| ContextOptions |
Hiermee haalt u het ObjectContextOptions exemplaar op dat opties bevat die van invloed zijn op het gedrag van de ObjectContext. |
| DefaultContainerName |
Hiermee haalt u de standaardcontainernaam op of stelt u deze in. |
| MetadataWorkspace |
Hiermee haalt u de werkruimte met metagegevens op die wordt gebruikt door de objectcontext. |
| ObjectStateManager |
Hiermee haalt u het objectstatusbeheer op dat door de objectcontext wordt gebruikt om objectwijzigingen bij te houden. |
| QueryProvider |
Hiermee haalt u de LINQ-queryprovider op die is gekoppeld aan deze objectcontext. |
Methoden
| Name | Description |
|---|---|
| AcceptAllChanges() |
Hiermee worden alle wijzigingen in objecten in de objectcontext geaccepteerd. |
| AddObject(String, Object) |
Hiermee voegt u een object toe aan de objectcontext. |
| ApplyCurrentValues<TEntity>(String, TEntity) |
Kopieert de scalaire waarden van het opgegeven object naar het object in de ObjectContext sleutel met dezelfde sleutel. |
| ApplyOriginalValues<TEntity>(String, TEntity) |
Kopieert de scalaire waarden van het opgegeven object in een set oorspronkelijke waarden voor het object in dezelfde ObjectContext sleutel. |
| ApplyPropertyChanges(String, Object) |
Verouderd.
Hiermee worden eigenschapswijzigingen van een losgekoppeld object toegepast op een object dat al aan de objectcontext is gekoppeld. |
| Attach(IEntityWithKey) |
Hiermee koppelt u een object- of objectgrafiek aan de objectcontext wanneer het object een entiteitssleutel heeft. |
| AttachTo(String, Object) |
Hiermee koppelt u een object- of objectgrafiek aan de objectcontext in een specifieke entiteitsset. |
| CreateDatabase() |
Hiermee maakt u de database met behulp van de huidige gegevensbronverbinding en de metagegevens in de StoreItemCollection. |
| CreateDatabaseScript() |
Hiermee wordt een DDL-script (Data Definition Language) gegenereerd waarmee schemaobjecten (tabellen, primaire sleutels, refererende sleutels) worden gemaakt voor de metagegevens in de StoreItemCollection. De StoreItemCollection metagegevens worden geladen uit SSDL-bestanden (Schema Definition Language). |
| CreateEntityKey(String, Object) |
Hiermee maakt u de entiteitssleutel voor een specifiek object of retourneert u de entiteitssleutel als deze al bestaat. |
| CreateObject<T>() |
Hiermee maakt en retourneert u een exemplaar van het aangevraagde type. |
| CreateObjectSet<TEntity>() |
Hiermee maakt u een nieuw ObjectSet<TEntity> exemplaar dat wordt gebruikt om objecten van het opgegeven entiteitstype op te vragen, toe te voegen, te wijzigen en te verwijderen. |
| CreateObjectSet<TEntity>(String) |
Hiermee maakt u een nieuw ObjectSet<TEntity> exemplaar dat wordt gebruikt voor het opvragen, toevoegen, wijzigen en verwijderen van objecten van het opgegeven type en met de naam van de opgegeven entiteitsset. |
| CreateProxyTypes(IEnumerable<Type>) |
Genereert een equivalent type dat kan worden gebruikt met entity framework voor elk type in de opgegeven opsomming. |
| CreateQuery<T>(String, ObjectParameter[]) |
Hiermee maakt u een ObjectQuery<T> in de huidige objectcontext met behulp van de opgegeven querytekenreeks. |
| DatabaseExists() |
Controleert of de database die is opgegeven als de database in de huidige gegevensbronverbinding bestaat op de gegevensbron. |
| DeleteDatabase() |
Hiermee verwijdert u de database die is opgegeven als de database in de huidige gegevensbronverbinding. |
| DeleteObject(Object) |
Hiermee wordt een object gemarkeerd voor verwijdering. |
| Detach(Object) |
Hiermee verwijdert u het object uit de objectcontext. |
| DetectChanges() |
Zorgt ervoor dat ObjectStateEntry wijzigingen worden gesynchroniseerd met wijzigingen in alle objecten die worden bijgehouden door de ObjectStateManager. |
| Dispose() |
Releases van de resources die worden gebruikt door de objectcontext. |
| Dispose(Boolean) |
Releases van de resources die worden gebruikt door de objectcontext. |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| ExecuteFunction(String, ObjectParameter[]) |
Voert een opgeslagen procedure of functie uit die is gedefinieerd in de gegevensbron en uitgedrukt in het conceptuele model; verwijdert alle resultaten die zijn geretourneerd door de functie; en retourneert het aantal rijen dat wordt beïnvloed door de uitvoering. |
| ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[]) |
Hiermee wordt de opgegeven opgeslagen procedure of functie uitgevoerd die is gedefinieerd in de gegevensbron en uitgedrukt in het conceptuele model, met de opgegeven parameters en de samenvoegoptie. Retourneert een getypte ObjectResult<T>. |
| ExecuteFunction<TElement>(String, ObjectParameter[]) |
Hiermee wordt een opgeslagen procedure of functie uitgevoerd die is gedefinieerd in de gegevensbron en die is toegewezen in het conceptuele model, met de opgegeven parameters. Retourneert een getypte ObjectResult<T>. |
| ExecuteStoreCommand(String, Object[]) |
Voert een willekeurige opdracht rechtstreeks uit op de gegevensbron met behulp van de bestaande verbinding. |
| ExecuteStoreQuery<TElement>(String, Object[]) |
Voert een query rechtstreeks uit op de gegevensbron die een reeks getypte resultaten retourneert. |
| ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[]) |
Voert een query rechtstreeks uit op de gegevensbron en retourneert een reeks getypte resultaten. Geef de entiteitsset en de samenvoegoptie op, zodat queryresultaten kunnen worden bijgehouden als entiteiten. |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetKnownProxyTypes() |
Retourneert alle bestaande proxytypen. |
| GetObjectByKey(EntityKey) |
Retourneert een object met de opgegeven entiteitssleutel. |
| GetObjectType(Type) |
Retourneert het entiteitstype van de POCO-entiteit die is gekoppeld aan een proxyobject van een opgegeven type. |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| LoadProperty(Object, String, MergeOption) |
Laadt expliciet een object dat is gerelateerd aan het opgegeven object door de opgegeven navigatie-eigenschap en met behulp van de opgegeven samenvoegoptie. |
| LoadProperty(Object, String) |
Laadt expliciet een object dat is gerelateerd aan het opgegeven object door de opgegeven navigatie-eigenschap en gebruikt de standaardoptie voor samenvoegen. |
| LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption) |
Laadt expliciet een object dat is gerelateerd aan het opgegeven object door de opgegeven LINQ-query en met behulp van de opgegeven samenvoegoptie. |
| LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>) |
Laadt expliciet een object dat is gerelateerd aan het opgegeven object door de opgegeven LINQ-query en met behulp van de standaardoptie voor samenvoegen. |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| Refresh(RefreshMode, IEnumerable) |
Hiermee werkt u een verzameling objecten in de objectcontext bij met gegevens uit de gegevensbron. |
| Refresh(RefreshMode, Object) |
Hiermee werkt u een object in de objectcontext bij met gegevens uit de gegevensbron. |
| SaveChanges() |
Alle updates voor de gegevensbron blijven behouden en het bijhouden van wijzigingen opnieuw instellen in de objectcontext. |
| SaveChanges(Boolean) |
Verouderd.
Alle updates voor de gegevensbron blijven behouden en het bijhouden van wijzigingen in de objectcontext optioneel opnieuw instellen. |
| SaveChanges(SaveOptions) |
Bewaart alle updates voor de gegevensbron met de opgegeven SaveOptions. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
| Translate<TElement>(DbDataReader) |
Vertaalt een DbDataReader met rijen entiteitsgegevens naar objecten van het aangevraagde entiteitstype. |
| Translate<TEntity>(DbDataReader, String, MergeOption) |
Vertaalt een DbDataReader met rijen entiteitsgegevens naar objecten van het aangevraagde entiteitstype, in een specifieke entiteitsset en met de opgegeven samenvoegoptie. |
| TryGetObjectByKey(EntityKey, Object) |
Retourneert een object met de opgegeven entiteitssleutel. |
gebeurtenis
| Name | Description |
|---|---|
| ObjectMaterialized |
Treedt op wanneer een nieuw entiteitsobject wordt gemaakt op basis van gegevens in de gegevensbron als onderdeel van een query- of laadbewerking. |
| SavingChanges |
Vindt plaats wanneer wijzigingen worden opgeslagen in de gegevensbron. |