EntityReference<TEntity> Osztály

Definíció

Névtér:

System.Data.Objects.DataClasses

Szerelvény:

System.Data.Entity.dll

Egy társítás kapcsolódó végét jelöli, amelynek többszöröse nulla vagy egy.

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

[<System.Runtime.Serialization.DataContract>]
[<System.Serializable>]
type EntityReference<'Entity (requires 'Entity : null)> = class
    inherit EntityReference

Public NotInheritable Class EntityReference(Of TEntity)
Inherits EntityReference

Típusparaméterek

TEntity

A hivatkozás entitástípusa.

Öröklődés

Object

RelatedEnd

EntityReference

EntityReference<TEntity>

Attribútumok

DataContractAttribute SerializableAttribute

Példák

Ez a példa bemutatja, hogyan módosíthatja az EntityReference<TEntity> objektum és egy kapcsolódó SalesOrderHeader objektum közötti Address kapcsolatot, amely a rendelés szállítási címét jelöli.

// 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);
}

Megjegyzések

Egy EntityReference<TEntity> objektumot egy navigációs tulajdonság ad vissza, ha a kapcsolódó vég értéke nulla vagy egy. További információ: NavigationProperty Elem (CSDL).

Egy EntityReference<TEntity> objektumnak lehet egy megfelelő EntityCollection<TEntity> (egy-a-többhöz kapcsolat) vagy EntityReference<TEntity> (egy-az-egyhez kapcsolat) a kapcsolat másik végén. Ha egy EntityReference<TEntity> és egy EntityCollection<TEntity> modell ellentétes véget ér ugyanannak a kapcsolatnak, a kapcsolat integritása az objektum szintjén marad fenn.

Ez az osztály nem örökölhető.

Konstruktorok

Name	Description
EntityReference<TEntity>()	Létrehoz egy új példányt a EntityReference<TEntity>.

Tulajdonságok

Name	Description
EntityKey	A kapcsolódó objektum kulcsát adja vissza. (Öröklődés forrása EntityReference)
IsLoaded	Olyan értéket kap, amely jelzi, hogy az összes kapcsolódó objektum be lett-e töltve. (Öröklődés forrása RelatedEnd)
RelationshipName	Lekéri annak a kapcsolatnak a nevét, amelyben ez a kapcsolódó végpont részt vesz. (Öröklődés forrása RelatedEnd)
RelationshipSet	Lekéri a kapcsolódó végpont metaadataira mutató hivatkozást. (Öröklődés forrása RelatedEnd)
SourceRoleName	Lekéri a szerepkör nevét a kapcsolat forrás végén. (Öröklődés forrása RelatedEnd)
TargetRoleName	Lekéri a szerepkör nevét a kapcsolat cél végén. (Öröklődés forrása RelatedEnd)
Value	Lekéri vagy beállítja az általa EntityReference<TEntity>visszaadott kapcsolódó objektumot.

Metódusok

Name	Description
Attach(TEntity)	Több-az-egyhez vagy egy-az-egyhez kapcsolatot hoz létre két objektum között az objektumkörnyezetben.
CreateSourceQuery()	Ezzel egyenértékű objektum-lekérdezést hoz létre, amely visszaadja a kapcsolódó objektumot.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetEnumerator()	Olyan értéket IEnumerator ad vissza, amely a kapcsolódó objektumok gyűjteményén keresztül iterál. (Öröklődés forrása RelatedEnd)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
Load()	Ha egy származtatott osztályban felülbírált, az alapértelmezett egyesítési beállítással betölti a kapcsolódó objektumot vagy objektumokat a kapcsolódó végére. (Öröklődés forrása RelatedEnd)
Load(MergeOption)	Betölti ehhez a kapcsolódó objektumot EntityReference<TEntity> a megadott egyesítési beállítással.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnDeserialized(StreamingContext)	Belsőleg az entitásobjektumok és a példányok deszerializálására RelationshipManager szolgál. (Öröklődés forrása RelatedEnd)
OnRefDeserialized(StreamingContext)	Ez a metódus belsőleg használható a kapcsolódó entitásobjektumok szerializálására.
OnSerializing(StreamingContext)	Ez a metódus belsőleg használható a kapcsolódó entitásobjektumok szerializálására.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

esemény

Name	Description
AssociationChanged	Ez akkor fordul elő, ha egy kapcsolódó végponton módosítás történik. (Öröklődés forrása RelatedEnd)

Explicit interfész-implementációk

Name	Description
IRelatedEnd.Add(IEntityWithRelationships)	Objektumot ad hozzá a kapcsolódó végponthoz. (Öröklődés forrása RelatedEnd)
IRelatedEnd.Add(Object)	Objektumot ad hozzá a kapcsolódó végponthoz. (Öröklődés forrása RelatedEnd)
IRelatedEnd.Attach(IEntityWithRelationships)	Objektum csatolása a kapcsolódó végén. (Öröklődés forrása RelatedEnd)
IRelatedEnd.Attach(Object)	Objektumot csatol a kapcsolódó végponthoz. (Öröklődés forrása RelatedEnd)
IRelatedEnd.CreateSourceQuery()	Olyan objektumot ad IEnumerable vissza, amely a kapcsolódó végponthoz tartozó objektumokat jelöli. (Öröklődés forrása RelatedEnd)
IRelatedEnd.Remove(IEntityWithRelationships)	Eltávolít egy objektumot a gyűjteményből a kapcsolódó végén. (Öröklődés forrása RelatedEnd)
IRelatedEnd.Remove(Object)	Eltávolít egy objektumot a kapcsolódó végpontról, ha az objektum a kapcsolódó végpont része. (Öröklődés forrása RelatedEnd)