ObjectContext.LoadProperty Metode

Definisi

Ruang nama:

System.Data.Objects

Rakitan:

System.Data.Entity.dll

Secara eksplisit memuat objek terkait saat Anda menggunakan kelas data kustom POCO.

Overload

LoadProperty(Object, String)	Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh properti navigasi yang ditentukan dan menggunakan opsi penggabungan default.
LoadProperty(Object, String, MergeOption)	Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh properti navigasi yang ditentukan dan menggunakan opsi penggabungan yang ditentukan.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh kueri LINQ yang ditentukan dan dengan menggunakan opsi penggabungan yang ditentukan.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh kueri LINQ yang ditentukan dan dengan menggunakan opsi penggabungan default.

Keterangan

Saat menggunakan kelas data kustom POCO, objek terkait tidak dapat dimuat secara eksplisit seperti instans jenis entitas yang dihasilkan oleh alat Model Data Entitas. Ini karena alat menghasilkan properti navigasi yang mengembalikan EntityCollection<TEntity> atau EntityReference<TEntity> objek terkait ketika Load dipanggil pada RelatedEnd. Entitas POCO masih dapat dimuat dengan menggunakan pemuatan malas dengan mengatur properti ke true pada instans ObjectContextOptions yang dikembalikan oleh ObjectContext.ContextOptions properti , atau dengan menggunakan pemuatan bersemangat dengan Include metode pada ObjectQuery<T>.LazyLoadingEnabled

LoadProperty(Object, String)

Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh properti navigasi yang ditentukan dan menggunakan opsi penggabungan default.

public:
 void LoadProperty(System::Object ^ entity, System::String ^ navigationProperty);

public void LoadProperty (object entity, string navigationProperty);

member this.LoadProperty : obj * string -> unit

Public Sub LoadProperty (entity As Object, navigationProperty As String)

Parameter

entity

Object

Entitas tempat objek terkait akan dimuat.

navigationProperty

String

Nama properti navigasi yang mengembalikan objek terkait yang akan dimuat.

Pengecualian

InvalidOperationException

entity dalam status Detached, Added atau Deleted ,

-atau-

entity dilampirkan ke instans lain dari ObjectContext.

Keterangan

Metode LoadProperty harus dipanggil untuk mencapai pemuatan eksplisit saat Anda menggunakan kelas data kustom POCO.

Setelah memanggil LoadProperty, objek terkait dapat diakses melalui properti navigasi entitas sumber.

Saat menggunakan kelas data kustom POCO, objek terkait tidak dapat dimuat secara eksplisit seperti instans jenis entitas yang dihasilkan oleh alat Model Data Entitas. Ini karena alat menghasilkan properti navigasi yang mengembalikan EntityCollection<TEntity> atau EntityReference<TEntity> objek terkait ketika Load dipanggil pada RelatedEnd. Entitas POCO masih dapat dimuat dengan menggunakan pemuatan malas dengan mengatur properti ke true pada instans ObjectContextOptions yang dikembalikan oleh ObjectContext.ContextOptions properti , atau dengan menggunakan pemuatan bersemangat dengan Include metode pada ObjectQuery<T>.LazyLoadingEnabled

Ketika metode dipanggilLoadProperty, objek dimuat ke dalam ObjectContext dengan menggunakan nilai default MergeOption .AppendOnly

LoadProperty(Object, String, MergeOption)

Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh properti navigasi yang ditentukan dan menggunakan opsi penggabungan yang ditentukan.

public:
 void LoadProperty(System::Object ^ entity, System::String ^ navigationProperty, System::Data::Objects::MergeOption mergeOption);

public void LoadProperty (object entity, string navigationProperty, System.Data.Objects.MergeOption mergeOption);

member this.LoadProperty : obj * string * System.Data.Objects.MergeOption -> unit

Public Sub LoadProperty (entity As Object, navigationProperty As String, mergeOption As MergeOption)

Parameter

entity

Object

Entitas tempat objek terkait akan dimuat.

navigationProperty

String

Nama properti navigasi yang mengembalikan objek terkait yang akan dimuat.

mergeOption

MergeOption

Nilai MergeOption yang akan digunakan saat Anda memuat objek terkait.

Pengecualian

InvalidOperationException

entity dalam status Detached, Added atau Deleted ,

-atau-

entity dilampirkan ke instans lain dari ObjectContext.

Keterangan

Metode LoadProperty harus dipanggil untuk mencapai pemuatan eksplisit saat Anda menggunakan kelas data kustom POCO.

Setelah memanggil LoadProperty, objek terkait dapat diakses melalui properti navigasi entitas sumber.

Saat menggunakan kelas data kustom POCO, objek terkait tidak dapat dimuat secara eksplisit seperti instans jenis entitas yang dihasilkan oleh alat Model Data Entitas. Ini karena alat menghasilkan properti navigasi yang mengembalikan EntityCollection<TEntity> atau EntityReference<TEntity> objek terkait ketika Load dipanggil pada RelatedEnd. Entitas POCO masih dapat dimuat dengan menggunakan pemuatan malas dengan mengatur properti ke true pada instans ObjectContextOptions yang dikembalikan oleh ObjectContext.ContextOptions properti , atau dengan menggunakan pemuatan bersemangat dengan Include metode pada ObjectQuery<T>.LazyLoadingEnabled

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)

Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh kueri LINQ yang ditentukan dan dengan menggunakan opsi penggabungan yang ditentukan.

public:
generic <typename TEntity>
 void LoadProperty(TEntity entity, System::Linq::Expressions::Expression<Func<TEntity, System::Object ^> ^> ^ selector, System::Data::Objects::MergeOption mergeOption);

public void LoadProperty<TEntity> (TEntity entity, System.Linq.Expressions.Expression<Func<TEntity,object>> selector, System.Data.Objects.MergeOption mergeOption);

member this.LoadProperty : 'Entity * System.Linq.Expressions.Expression<Func<'Entity, obj>> * System.Data.Objects.MergeOption -> unit

Public Sub LoadProperty(Of TEntity) (entity As TEntity, selector As Expression(Of Func(Of TEntity, Object)), mergeOption As MergeOption)

Jenis parameter

TEntity

Jenis objek yang disediakan.

Parameter

entity

TEntity

Objek sumber tempat objek terkait akan dimuat.

selector

Expression<Func<TEntity,Object>>

Ekspresi LINQ yang menentukan objek terkait yang akan dimuat.

mergeOption

MergeOption

Nilai MergeOption yang akan digunakan saat Anda memuat objek terkait.

Pengecualian

ArgumentException

selector tidak menyediakan parameter input yang valid.

ArgumentNullException

selector adalah null.

InvalidOperationException

entity dalam status Detached, Added atau Deleted ,

-atau-

entity dilampirkan ke instans lain dari ObjectContext.

Keterangan

Metode LoadProperty harus dipanggil untuk mencapai pemuatan eksplisit saat Anda menggunakan kelas data kustom POCO.

Setelah memanggil LoadProperty, objek terkait dapat diakses melalui properti navigasi entitas sumber.

Properti yang akan dimuat ditentukan oleh ekspresi LINQ, yang harus dalam bentuk akses anggota properti sederhana, seperti di (entity) => entity.PropertyName mana PropertyName adalah properti navigasi yang mengembalikan objek terkait yang akan dimuat. Pengecualian akan terjadi jika bentuk ekspresi LINQ lain digunakan.

Saat menggunakan kelas data kustom POCO, objek terkait tidak dapat dimuat secara eksplisit seperti instans jenis entitas yang dihasilkan oleh alat Model Data Entitas. Ini karena alat menghasilkan properti navigasi yang mengembalikan EntityCollection<TEntity> atau EntityReference<TEntity> objek terkait ketika Load dipanggil pada RelatedEnd. Entitas POCO masih dapat dimuat dengan menggunakan pemuatan malas dengan mengatur properti ke true pada instans ObjectContextOptions yang dikembalikan oleh ObjectContext.ContextOptions properti , atau dengan menggunakan pemuatan bersemangat dengan Include metode pada ObjectQuery<T>.LazyLoadingEnabled

LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)

Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh kueri LINQ yang ditentukan dan dengan menggunakan opsi penggabungan default.

public:
generic <typename TEntity>
 void LoadProperty(TEntity entity, System::Linq::Expressions::Expression<Func<TEntity, System::Object ^> ^> ^ selector);

public void LoadProperty<TEntity> (TEntity entity, System.Linq.Expressions.Expression<Func<TEntity,object>> selector);

member this.LoadProperty : 'Entity * System.Linq.Expressions.Expression<Func<'Entity, obj>> -> unit

Public Sub LoadProperty(Of TEntity) (entity As TEntity, selector As Expression(Of Func(Of TEntity, Object)))

Jenis parameter

TEntity

Jenis objek yang disediakan.

Parameter

entity

TEntity

Objek sumber tempat objek terkait akan dimuat.

selector

Expression<Func<TEntity,Object>>

Ekspresi LINQ yang menentukan objek terkait yang akan dimuat.

Pengecualian

ArgumentException

selector tidak menyediakan parameter input yang valid.

ArgumentNullException

selector adalah null.

InvalidOperationException

entity dalam status Detached, Added atau Deleted ,

-atau-

entity dilampirkan ke instans lain dari ObjectContext.

Keterangan

Metode LoadProperty harus dipanggil untuk mencapai pemuatan eksplisit saat Anda menggunakan kelas data kustom POCO.

Setelah memanggil LoadProperty, objek terkait dapat diakses melalui properti navigasi entitas sumber.

Properti yang akan dimuat ditentukan oleh ekspresi LINQ, yang harus dalam bentuk akses anggota properti sederhana, seperti dalam , di (entity) => entity.PropertyNamemana PropertyName adalah properti navigasi yang mengembalikan objek terkait yang akan dimuat. Pengecualian akan terjadi jika bentuk ekspresi LINQ lain digunakan.

Saat menggunakan kelas data kustom POCO, objek terkait tidak dapat dimuat secara eksplisit seperti instans jenis entitas yang dihasilkan oleh alat Model Data Entitas. Ini karena alat menghasilkan properti navigasi yang mengembalikan EntityCollection<TEntity> atau EntityReference<TEntity> objek terkait ketika Load dipanggil pada RelatedEnd. Entitas POCO masih dapat dimuat dengan menggunakan pemuatan malas dengan mengatur properti ke true pada instans ObjectContextOptions yang dikembalikan oleh ObjectContext.ContextOptions properti , atau dengan menggunakan pemuatan bersemangat dengan Include metode pada ObjectQuery<T>.LazyLoadingEnabled