EntityReference<TEntity> Klas

Definitie

Vertegenwoordigt een gerelateerd einde van een koppeling met een multipliciteit van nul of één.

generic <typename TEntity>
 where TEntity : class, IEntityWithRelationshipspublic ref class EntityReference sealed : System::Data::Objects::DataClasses::EntityReference
generic <typename TEntity>
 where TEntity : classpublic ref class EntityReference sealed : System::Data::Objects::DataClasses::EntityReference
[System.Runtime.Serialization.DataContract]
[System.Serializable]
public sealed class EntityReference<TEntity> : System.Data.Objects.DataClasses.EntityReference where TEntity : class, IEntityWithRelationships
[System.Runtime.Serialization.DataContract]
[System.Serializable]
public sealed class EntityReference<TEntity> : System.Data.Objects.DataClasses.EntityReference where TEntity : class
[<System.Runtime.Serialization.DataContract>]
[<System.Serializable>]
type EntityReference<'Entity (requires 'Entity : null and 'Entity :> IEntityWithRelationships)> = class
    inherit EntityReference
[<System.Runtime.Serialization.DataContract>]
[<System.Serializable>]
type EntityReference<'Entity (requires 'Entity : null)> = class
    inherit EntityReference
Public NotInheritable Class EntityReference(Of TEntity)
Inherits EntityReference

Type parameters

TEntity

Het entiteitstype van de verwijzing.

Overname
EntityReference<TEntity>
Kenmerken

Voorbeelden

In dit voorbeeld ziet u hoe u het EntityReference<TEntity> object gebruikt om een relatie te wijzigen tussen een SalesOrderHeader object en een gerelateerd Address object dat het verzendadres voor de order vertegenwoordigt.


// Define the order and new address IDs.
int orderId = 43669;
int addressId = 26;

using (AdventureWorksEntities context
    = new AdventureWorksEntities())
{
    // Get the billing address to change to.
    Address address =
        context.Addresses.Single(c => c.AddressID == addressId);

    // Get the order being changed.
    SalesOrderHeader order =
        context.SalesOrderHeaders.Single(o => o.SalesOrderID == orderId);

    // You do not have to call the Load method to load the addresses for the order,
    // because  lazy loading is set to true
    // by the constructor of the AdventureWorksEntities object.
    // With  lazy loading set to true the related objects are loaded when
    // you access the navigation property. In this case Address.

    // Write the current billing street address.
    Console.WriteLine("Current street: "
        + order.Address.AddressLine1);

    // Change the billing address.
    if (!order.Address.Equals(address))
    {
        // Use Address navigation property to change the association.
        order.Address = address;

        // Write the changed billing street address.
        Console.WriteLine("Changed street: "
            + order.Address.AddressLine1);
    }

    // If the address change succeeds, save the changes.
    context.SaveChanges();

    // Write the current billing street address.
    Console.WriteLine("Current street: "
        + order.Address.AddressLine1);
}

Opmerkingen

Een EntityReference<TEntity> object wordt geretourneerd door een navigatie-eigenschap wanneer het gerelateerde einde een multipliciteit van nul of één heeft. Zie Het element NavigationProperty (CSDL) voor meer informatie.

Een EntityReference<TEntity> object kan een bijbehorende EntityCollection<TEntity> (een-op-veel-relatie) of EntityReference<TEntity> (een-op-een-relatie) aan het andere einde van de relatie hebben. Wanneer een EntityReference<TEntity> en een EntityCollection<TEntity> model tegen het einde van dezelfde relatie staan, blijft de integriteit van de relatie behouden op objectniveau.

Deze klasse kan niet worden overgenomen.

Constructors

Name Description
EntityReference<TEntity>()

Hiermee maakt u een nieuw exemplaar van EntityReference<TEntity>.

Eigenschappen

Name Description
EntityKey

Retourneert de sleutel voor het gerelateerde object.

(Overgenomen van EntityReference)
IsLoaded

Hiermee wordt een waarde opgehaald die aangeeft of alle gerelateerde objecten zijn geladen.

(Overgenomen van RelatedEnd)
RelationshipName

Hiermee haalt u de naam op van de relatie waarin dit gerelateerde einde deelneemt.

(Overgenomen van RelatedEnd)
RelationshipSet

Hiermee haalt u een verwijzing op naar de metagegevens voor het gerelateerde einde.

(Overgenomen van RelatedEnd)
SourceRoleName

Hiermee haalt u de rolnaam op aan het broneinde van de relatie.

(Overgenomen van RelatedEnd)
TargetRoleName

Hiermee haalt u de rolnaam op aan het doeleinde van de relatie.

(Overgenomen van RelatedEnd)
Value

Hiermee wordt het gerelateerde object opgehaald of ingesteld dat door dit EntityReference<TEntity>object wordt geretourneerd.

Methoden

Name Description
Attach(TEntity)

Hiermee maakt u een veel-op-een- of een-op-een-relatie tussen twee objecten in de objectcontext.

Attach<TEntity>(IEnumerable<TEntity>, Boolean)

Hiermee definieert u een relatie tussen twee gekoppelde objecten.

(Overgenomen van RelatedEnd)
CreateSourceQuery()

Hiermee maakt u een equivalente objectquery die het gerelateerde object retourneert.

Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetEnumerator()

Retourneert een IEnumerator die door de verzameling gerelateerde objecten wordt herhaald.

(Overgenomen van RelatedEnd)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
Load()

Wanneer het wordt overschreven in een afgeleide klasse, laadt u het gerelateerde object of de gerelateerde objecten in het gerelateerde einde met de standaardoptie voor samenvoegen.

(Overgenomen van RelatedEnd)
Load(MergeOption)

Laadt het gerelateerde object hiervoor EntityReference<TEntity> met de opgegeven optie voor samenvoegen.

MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
Merge<TEntity>(IEnumerable<TEntity>, MergeOption, Boolean)

Voegt gerelateerde entiteiten samen in de lokale EntityCollection<TEntity>.

(Overgenomen van RelatedEnd)
OnDeserialized(StreamingContext)

Intern gebruikt om entiteitsobjecten samen met de RelationshipManager exemplaren te deserialiseren.

(Overgenomen van RelatedEnd)
OnRefDeserialized(StreamingContext)

Deze methode wordt intern gebruikt om gerelateerde entiteitsobjecten te serialiseren.

OnSerializing(StreamingContext)

Deze methode wordt intern gebruikt om gerelateerde entiteitsobjecten te serialiseren.

ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)
ValidateEntityForAttach<TEntity>(TEntity, Int32, Boolean)

Bepaalt of een object kan worden gekoppeld aan de lokale verzameling of verwijzing.

(Overgenomen van RelatedEnd)
ValidateLoad<TEntity>(MergeOption, String)

Zorgt ervoor dat het gerelateerde object of de gerelateerde objecten kunnen worden geladen in de lokale verzameling of verwijzing.

(Overgenomen van RelatedEnd)
ValidateOwnerForAttach()

Zorgt ervoor dat het object waartoe het gerelateerde einde behoort, een bijlagebewerking ondersteunt.

(Overgenomen van RelatedEnd)

gebeurtenis

Name Description
AssociationChanged

Treedt op wanneer een wijziging wordt aangebracht in een gerelateerd einde.

(Overgenomen van RelatedEnd)

Expliciete interface-implementaties

Name Description
IRelatedEnd.Add(IEntityWithRelationships)

Hiermee voegt u een object toe aan het gerelateerde einde.

(Overgenomen van RelatedEnd)
IRelatedEnd.Add(Object)

Hiermee voegt u een object toe aan het gerelateerde einde.

(Overgenomen van RelatedEnd)
IRelatedEnd.Attach(IEntityWithRelationships)

Hiermee wordt een object aan het gerelateerde einde gekoppeld.

(Overgenomen van RelatedEnd)
IRelatedEnd.Attach(Object)

Hiermee wordt een object gekoppeld aan het gerelateerde einde.

(Overgenomen van RelatedEnd)
IRelatedEnd.CreateSourceQuery()

Hiermee wordt een IEnumerable object geretourneerd dat de objecten vertegenwoordigt die deel uitmaken van het gerelateerde einde.

(Overgenomen van RelatedEnd)
IRelatedEnd.Remove(IEntityWithRelationships)

Hiermee verwijdert u een object uit de verzameling aan het gerelateerde einde.

(Overgenomen van RelatedEnd)
IRelatedEnd.Remove(Object)

Hiermee verwijdert u een object uit het gerelateerde einde als het object deel uitmaakt van het gerelateerde einde.

(Overgenomen van RelatedEnd)

Van toepassing op