Udostępnij za pośrednictwem


EntityReference<TEntity> Klasa

Definicja

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

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

Parametry typu

TEntity

Typ jednostki odwołania.

Dziedziczenie
EntityReference<TEntity>
Atrybuty

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)

Dotyczy