EntityReference<TEntity> Klasa

Definicja

Przestrzeń nazw:

System.Data.Objects.DataClasses

Zestaw:

System.Data.Entity.dll

Reprezentuje powiązany koniec skojarzenia z wielokrotnością zera lub jednego.

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

Parametry typu

TEntity

Typ jednostki odwołania.

Dziedziczenie

Object

RelatedEnd

EntityReference

EntityReference<TEntity>

Atrybuty

DataContractAttribute SerializableAttribute

Przykłady

W tym przykładzie pokazano, jak za pomocą EntityReference<TEntity> obiektu zmienić relację między obiektem SalesOrderHeader a powiązanym Address obiektem reprezentującym adres wysyłkowy zamówienia.

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

Uwagi

EntityReference<TEntity> Obiekt jest zwracany przez właściwość nawigacji, gdy powiązany koniec ma wiele wartości zero lub jeden. Aby uzyskać więcej informacji, zobacz NavigationProperty, Element (CSDL).

Obiekt EntityReference<TEntity> może mieć odpowiadającą EntityCollection<TEntity> relację (jeden do wielu) lub EntityReference<TEntity> (relację jeden do jednego) na drugim końcu relacji. Gdy obiekt EntityReference<TEntity> i EntityCollection<TEntity> model sprzeciwiający się kończy tę samą relację, integralność relacji jest utrzymywana na poziomie obiektu.

Klasa ta nie może być dziedziczona.

Konstruktory

Nazwa	Opis
EntityReference<TEntity>()	Tworzy nowe wystąpienie klasy EntityReference<TEntity>.

Właściwości

Nazwa	Opis
EntityKey	Zwraca klucz dla powiązanego obiektu. (Odziedziczone po EntityReference)
IsLoaded	Pobiera wartość wskazującą, czy wszystkie powiązane obiekty zostały załadowane. (Odziedziczone po RelatedEnd)
RelationshipName	Pobiera nazwę relacji, w której uczestniczy ten powiązany koniec. (Odziedziczone po RelatedEnd)
RelationshipSet	Pobiera odwołanie do metadanych powiązanego końca. (Odziedziczone po RelatedEnd)
SourceRoleName	Pobiera nazwę roli na końcu źródłowej relacji. (Odziedziczone po RelatedEnd)
TargetRoleName	Pobiera nazwę roli na końcu docelowej relacji. (Odziedziczone po RelatedEnd)
Value	Pobiera lub ustawia powiązany obiekt zwrócony przez ten EntityReference<TEntity>obiekt .

Metody

Nazwa	Opis
Attach(TEntity)	Tworzy relację wiele-do-jednego lub jeden-do-jednego między dwoma obiektami w kontekście obiektu.
CreateSourceQuery()	Tworzy zapytanie o obiekt równoważny, które zwraca powiązany obiekt.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetEnumerator()	Zwraca obiekt IEnumerator , który iteruje przez kolekcję powiązanych obiektów. (Odziedziczone po RelatedEnd)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
Load()	Po zastąpieniu w klasie pochodnej ładuje powiązany obiekt lub obiekty do powiązanego końca z domyślną opcją scalania. (Odziedziczone po RelatedEnd)
Load(MergeOption)	Ładuje powiązany obiekt dla tego EntityReference<TEntity> z określoną opcją scalania.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
OnDeserialized(StreamingContext)	Używany wewnętrznie do deserializacji obiektów jednostek wraz z RelationshipManager wystąpieniami. (Odziedziczone po RelatedEnd)
OnRefDeserialized(StreamingContext)	Ta metoda jest używana wewnętrznie do serializacji powiązanych obiektów jednostek.
OnSerializing(StreamingContext)	Ta metoda jest używana wewnętrznie do serializacji powiązanych obiektów jednostek.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

Nazwa	Opis
AssociationChanged	Występuje po wprowadzeniu zmiany na powiązanym końcu. (Odziedziczone po RelatedEnd)

Jawne implementacje interfejsu

Nazwa	Opis
IRelatedEnd.Add(IEntityWithRelationships)	Dodaje obiekt do powiązanego końca. (Odziedziczone po RelatedEnd)
IRelatedEnd.Add(Object)	Dodaje obiekt do powiązanego końca. (Odziedziczone po RelatedEnd)
IRelatedEnd.Attach(IEntityWithRelationships)	Dołącza obiekt na powiązanym końcu. (Odziedziczone po RelatedEnd)
IRelatedEnd.Attach(Object)	Dołącza obiekt do powiązanego końca. (Odziedziczone po RelatedEnd)
IRelatedEnd.CreateSourceQuery()	Zwraca obiekt IEnumerable reprezentujący obiekty należące do powiązanego końca. (Odziedziczone po RelatedEnd)
IRelatedEnd.Remove(IEntityWithRelationships)	Usuwa obiekt z kolekcji na powiązanym końcu. (Odziedziczone po RelatedEnd)
IRelatedEnd.Remove(Object)	Usuwa obiekt z powiązanego końca, jeśli obiekt jest częścią powiązanego końca. (Odziedziczone po RelatedEnd)