EntityReference<TEntity> Kelas

Definisi

Ruang nama:

System.Data.Objects.DataClasses

Rakitan:

System.Data.Entity.dll

Mewakili akhir terkait dari asosiasi dengan perkalian nol atau satu.

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

Jenis parameter

TEntity

Jenis entitas referensi.

Warisan

Object

RelatedEnd

EntityReference

EntityReference<TEntity>

Atribut

DataContractAttribute SerializableAttribute

Contoh

Contoh ini menunjukkan cara menggunakan EntityReference<TEntity> objek untuk mengubah hubungan antara SalesOrderHeader objek dan objek terkait Address yang mewakili alamat pengiriman untuk pesanan.

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

Keterangan

Objek EntityReference<TEntity> dikembalikan oleh properti navigasi ketika akhir terkait memiliki perkalian nol atau satu. Untuk informasi selengkapnya, lihat NavigationProperty Element (CSDL).

Objek EntityReference<TEntity> mungkin memiliki hubungan yang sesuai EntityCollection<TEntity> (hubungan satu ke banyak) atau EntityReference<TEntity> (hubungan satu-ke-satu) di akhir hubungan lainnya. EntityReference<TEntity> Ketika model dan yang EntityCollection<TEntity> berlawanan dengan akhir hubungan yang sama, integritas hubungan dipertahankan pada tingkat objek.

Kelas ini tidak dapat diwariskan.

Konstruktor

EntityReference<TEntity>()

Membuat instans baru .EntityReference<TEntity>

Properti

EntityKey	Mengembalikan kunci untuk objek terkait. (Diperoleh dari EntityReference)
IsLoaded	Mendapatkan nilai yang menunjukkan apakah semua objek terkait telah dimuat. (Diperoleh dari RelatedEnd)
RelationshipName	Mendapatkan nama hubungan tempat akhir terkait ini berpartisipasi. (Diperoleh dari RelatedEnd)
RelationshipSet	Mendapatkan referensi ke metadata untuk akhir terkait. (Diperoleh dari RelatedEnd)
SourceRoleName	Mendapatkan nama peran di akhir sumber hubungan. (Diperoleh dari RelatedEnd)
TargetRoleName	Mendapatkan nama peran di akhir target hubungan. (Diperoleh dari RelatedEnd)
Value	Mendapatkan atau mengatur objek terkait yang dikembalikan oleh ini EntityReference<TEntity>.

Metode

Attach(TEntity)	Membuat hubungan banyak-ke-satu atau satu-ke-satu antara dua objek dalam konteks objek.
Attach<TEntity>(IEnumerable<TEntity>, Boolean)	Menentukan hubungan antara dua objek terlampir. (Diperoleh dari RelatedEnd)
CreateSourceQuery()	Membuat kueri objek yang setara yang mengembalikan objek terkait.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetEnumerator()	Mengembalikan yang IEnumerator melakukan iterasi melalui kumpulan objek terkait. (Diperoleh dari RelatedEnd)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
Load()	Saat ditimpa di kelas turunan, memuat objek atau objek terkait ke akhir terkait dengan opsi penggabungan default. (Diperoleh dari RelatedEnd)
Load(MergeOption)	Memuat objek terkait untuk ini EntityReference<TEntity> dengan opsi penggabungan yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
Merge<TEntity>(IEnumerable<TEntity>, MergeOption, Boolean)	Menggabungkan entitas terkait ke dalam lokal EntityCollection<TEntity>. (Diperoleh dari RelatedEnd)
OnDeserialized(StreamingContext)	Digunakan secara internal untuk mendeserialisasi objek entitas bersama dengan RelationshipManager instans. (Diperoleh dari RelatedEnd)
OnRefDeserialized(StreamingContext)	Metode ini digunakan secara internal untuk menserialisasikan objek entitas terkait.
OnSerializing(StreamingContext)	Metode ini digunakan secara internal untuk menserialisasikan objek entitas terkait.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
ValidateEntityForAttach<TEntity>(TEntity, Int32, Boolean)	Menentukan apakah objek dapat dilampirkan ke koleksi atau referensi lokal. (Diperoleh dari RelatedEnd)
ValidateLoad<TEntity>(MergeOption, String)	Memastikan bahwa objek atau objek terkait dapat berhasil dimuat ke dalam koleksi atau referensi lokal. (Diperoleh dari RelatedEnd)
ValidateOwnerForAttach()	Memastikan bahwa objek tempat ujung terkait berada mendukung operasi lampirkan. (Diperoleh dari RelatedEnd)

Acara

AssociationChanged

Terjadi ketika perubahan dilakukan pada akhir terkait. (Diperoleh dari RelatedEnd)

Implementasi Antarmuka Eksplisit

IRelatedEnd.Add(IEntityWithRelationships)	Menambahkan objek ke akhir terkait. (Diperoleh dari RelatedEnd)
IRelatedEnd.Add(Object)	Menambahkan objek ke akhir terkait. (Diperoleh dari RelatedEnd)
IRelatedEnd.Attach(IEntityWithRelationships)	Melampirkan objek di akhir terkait. (Diperoleh dari RelatedEnd)
IRelatedEnd.Attach(Object)	Melampirkan objek ke ujung terkait. (Diperoleh dari RelatedEnd)
IRelatedEnd.CreateSourceQuery()	Mengembalikan yang IEnumerable mewakili objek milik akhir terkait. (Diperoleh dari RelatedEnd)
IRelatedEnd.Remove(IEntityWithRelationships)	Menghapus objek dari koleksi di akhir terkait. (Diperoleh dari RelatedEnd)
IRelatedEnd.Remove(Object)	Menghapus objek dari ujung terkait jika objek adalah bagian dari akhir terkait. (Diperoleh dari RelatedEnd)