EntityReference<TEntity> Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili akhir terkait dari asosiasi dengan perkalian nol atau satu.
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
Jenis parameter
- TEntity
Jenis entitas referensi.
- Warisan
- Atribut
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) |