EntityReference<TEntity> Klasse

Definition

Stellt ein verwandtes Ende einer Zuordnung mit einer Multiplikation von Null oder 1 dar.

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

Typparameter

TEntity

Der Entitätstyp des Verweises.

Vererbung
EntityReference<TEntity>
Attribute

Beispiele

In diesem Beispiel wird gezeigt, wie Sie mithilfe des EntityReference<TEntity> Objekts eine Beziehung zwischen einem SalesOrderHeader Objekt und einem verknüpften Address Objekt ändern, das die Lieferadresse für die Bestellung darstellt.


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

Hinweise

Ein EntityReference<TEntity> Objekt wird von einer Navigationseigenschaft zurückgegeben, wenn das zugehörige Ende eine Multiplikation von Null oder 1 aufweist. Weitere Informationen finden Sie unter NavigationProperty Element (CSDL).For more information, see NavigationProperty Element (CSDL).

Ein EntityReference<TEntity> Objekt verfügt möglicherweise über eine entsprechende EntityCollection<TEntity> (1:n-Beziehung) oder EntityReference<TEntity> (1:1-Beziehung) am anderen Ende der Beziehung. Wenn ein EntityReference<TEntity> und ein EntityCollection<TEntity> Modell gegensätzliche Enden derselben Beziehung endet, wird die Integrität der Beziehung auf Objektebene beibehalten.

Diese Klasse kann nicht vererbt werden.

Konstruktoren

Name Beschreibung
EntityReference<TEntity>()

Erstellt eine neue Instanz von EntityReference<TEntity>.

Eigenschaften

Name Beschreibung
EntityKey

Gibt den Schlüssel für das zugehörige Objekt zurück.

(Geerbt von EntityReference)
IsLoaded

Ruft einen Wert ab, der angibt, ob alle zugehörigen Objekte geladen wurden.

(Geerbt von RelatedEnd)
RelationshipName

Ruft den Namen der Beziehung ab, an der dieses verwandte Ende teilnimmt.

(Geerbt von RelatedEnd)
RelationshipSet

Ruft einen Verweis auf die Metadaten für das verwandte Ende ab.

(Geerbt von RelatedEnd)
SourceRoleName

Ruft den Rollennamen am Quellende der Beziehung ab.

(Geerbt von RelatedEnd)
TargetRoleName

Ruft den Rollennamen am Zielende der Beziehung ab.

(Geerbt von RelatedEnd)
Value

Dient zum Abrufen oder Festlegen des verknüpften Objekts, das von diesem EntityReference<TEntity>zurückgegeben wird.

Methoden

Name Beschreibung
Attach(TEntity)

Erstellt eine 1:1- oder 1:1-Beziehung zwischen zwei Objekten im Objektkontext.

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

Definiert eine Beziehung zwischen zwei angefügten Objekten.

(Geerbt von RelatedEnd)
CreateSourceQuery()

Erstellt eine entsprechende Objektabfrage, die das zugehörige Objekt zurückgibt.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetEnumerator()

Gibt einen IEnumerator Wert zurück, der die Auflistung verwandter Objekte durchläuft.

(Geerbt von RelatedEnd)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
Load()

Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird das zugehörige Objekt oder die zugehörigen Objekte mit der Standarddruckoption in das zugehörige Ende geladen.

(Geerbt von RelatedEnd)
Load(MergeOption)

Lädt das zugehörige Objekt dafür EntityReference<TEntity> mit der angegebenen Zusammenführungsoption.

MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
Merge<TEntity>(IEnumerable<TEntity>, MergeOption, Boolean)

Führt verwandte Entitäten mit der lokalen EntityCollection<TEntity>Zusammenführung zusammen.

(Geerbt von RelatedEnd)
OnDeserialized(StreamingContext)

Wird intern verwendet, um Entitätsobjekte zusammen mit den RelationshipManager Instanzen zu deserialisieren.

(Geerbt von RelatedEnd)
OnRefDeserialized(StreamingContext)

Diese Methode wird intern verwendet, um verwandte Entitätsobjekte zu serialisieren.

OnSerializing(StreamingContext)

Diese Methode wird intern verwendet, um verwandte Entitätsobjekte zu serialisieren.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
ValidateEntityForAttach<TEntity>(TEntity, Int32, Boolean)

Bestimmt, ob ein Objekt an die lokale Auflistung oder den lokalen Verweis angefügt werden kann.

(Geerbt von RelatedEnd)
ValidateLoad<TEntity>(MergeOption, String)

Stellt sicher, dass das zugehörige Objekt oder die zugehörigen Objekte erfolgreich in die lokale Auflistung oder den Lokalen Verweis geladen werden können.

(Geerbt von RelatedEnd)
ValidateOwnerForAttach()

Stellt sicher, dass das Objekt, zu dem das zugehörige Ende gehört, einen Anfügungsvorgang unterstützt.

(Geerbt von RelatedEnd)

Ereignisse

Name Beschreibung
AssociationChanged

Tritt auf, wenn eine Änderung an einem verwandten Ende vorgenommen wird.

(Geerbt von RelatedEnd)

Explizite Schnittstellenimplementierungen

Name Beschreibung
IRelatedEnd.Add(IEntityWithRelationships)

Fügt dem zugehörigen Ende ein Objekt hinzu.

(Geerbt von RelatedEnd)
IRelatedEnd.Add(Object)

Fügt dem zugehörigen Ende ein Objekt hinzu.

(Geerbt von RelatedEnd)
IRelatedEnd.Attach(IEntityWithRelationships)

Fügt ein Objekt am zugehörigen Ende an.

(Geerbt von RelatedEnd)
IRelatedEnd.Attach(Object)

Fügt ein Objekt an das zugehörige Ende an.

(Geerbt von RelatedEnd)
IRelatedEnd.CreateSourceQuery()

Gibt einen IEnumerable Wert zurück, der die Objekte darstellt, die zum verwandten Ende gehören.

(Geerbt von RelatedEnd)
IRelatedEnd.Remove(IEntityWithRelationships)

Entfernt ein Objekt aus der Auflistung am zugehörigen Ende.

(Geerbt von RelatedEnd)
IRelatedEnd.Remove(Object)

Entfernt ein Objekt vom zugehörigen Ende, wenn das Objekt Teil des zugehörigen Endes ist.

(Geerbt von RelatedEnd)

Gilt für: