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 wielokrotność zera lub jednego. Aby uzyskać więcej informacji, zobacz NavigationProperty, element (CSDL).

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

Klasa ta nie może być dziedziczona.

Konstruktory

EntityReference<TEntity>()

Tworzy nowe wystąpienie klasy EntityReference<TEntity>.

Właściwości

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 dla 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

Attach(TEntity)	Tworzy relację wiele do jednego lub jeden do jednego między dwoma obiektami w kontekście obiektu.
Attach<TEntity>(IEnumerable<TEntity>, Boolean)	Definiuje relację między dwoma dołączonymi obiektami. (Odziedziczone po RelatedEnd)
CreateSourceQuery()	Tworzy równoważne zapytanie obiektu zwracające powiązany obiekt.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetEnumerator()	Zwraca iteracje IEnumerator po kolekcji powiązanych obiektów. (Odziedziczone po RelatedEnd)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (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 Objectelementu . (Odziedziczone po Object)
Merge<TEntity>(IEnumerable<TEntity>, MergeOption, Boolean)	Scala powiązane jednostki z lokalnym EntityCollection<TEntity>elementem . (Odziedziczone po RelatedEnd)
OnDeserialized(StreamingContext)	Używane 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)
ValidateEntityForAttach<TEntity>(TEntity, Int32, Boolean)	Określa, czy obiekt można dołączyć do kolekcji lokalnej, czy odwołania. (Odziedziczone po RelatedEnd)
ValidateLoad<TEntity>(MergeOption, String)	Gwarantuje, że powiązane obiekty lub obiekty można pomyślnie załadować do lokalnej kolekcji lub odwołania. (Odziedziczone po RelatedEnd)
ValidateOwnerForAttach()	Gwarantuje, że obiekt, do którego należy powiązany koniec, obsługuje operację dołączania. (Odziedziczone po RelatedEnd)

Zdarzenia

AssociationChanged

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

Jawne implementacje interfejsu

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)