DataServiceContext.BeginLoadProperty 方法

定義

命名空間:

System.Data.Services.Client

組件:

System.Data.Services.Client.dll

開始進行從資料服務載入指定的屬性值。

多載

BeginLoadProperty(Object, String, AsyncCallback, Object)	從資料服務非同步載入指定之屬性的值。
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)	透過使用提供的查詢接續物件，以非同步方式從資料服務載入下一頁相關實體。
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)	透過使用提供的下一個連結 URI，以非同步方式從資料服務載入一頁相關實體。

BeginLoadProperty(Object, String, AsyncCallback, Object)

從資料服務非同步載入指定之屬性的值。

public:
 IAsyncResult ^ BeginLoadProperty(System::Object ^ entity, System::String ^ propertyName, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginLoadProperty (object entity, string propertyName, AsyncCallback callback, object state);

member this.BeginLoadProperty : obj * string * AsyncCallback * obj -> IAsyncResult

Public Function BeginLoadProperty (entity As Object, propertyName As String, callback As AsyncCallback, state As Object) As IAsyncResult

參數

entity

Object

包含要載入之屬性的實體。

propertyName

String

要載入的指定之實體上的屬性名稱。

callback

AsyncCallback

接收到對要求的回應時所呼叫的委派。

state

Object

使用者定義的狀態物件，用於將內容資料傳遞給回呼方法。

傳回

IAsyncResult

IAsyncResult，表示非同步作業的狀態。

備註

呼叫這個方法會叫用擷取屬性值的網路作業。 指定的屬性可能是實體上的任何一個屬性，包括代表關聯或連結的屬性。 如果屬性表示關聯或連結或是擱置的屬性，呼叫這個方法則會提供用戶端一個延遲載入資源的方式。 如果實體處於已修改狀態，屬性值會載入相關實體，並將這些實體和任何連結標記成未變更。

如果已載入該屬性，則呼叫此方法會讓您重新整理屬性的值。

BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)

透過使用提供的查詢接續物件，以非同步方式從資料服務載入下一頁相關實體。

public:
 IAsyncResult ^ BeginLoadProperty(System::Object ^ entity, System::String ^ propertyName, System::Data::Services::Client::DataServiceQueryContinuation ^ continuation, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginLoadProperty (object entity, string propertyName, System.Data.Services.Client.DataServiceQueryContinuation continuation, AsyncCallback callback, object state);

member this.BeginLoadProperty : obj * string * System.Data.Services.Client.DataServiceQueryContinuation * AsyncCallback * obj -> IAsyncResult

Public Function BeginLoadProperty (entity As Object, propertyName As String, continuation As DataServiceQueryContinuation, callback As AsyncCallback, state As Object) As IAsyncResult

參數

entity

Object

包含要載入之屬性的實體。

propertyName

String

要載入的指定之實體的屬性名稱。

continuation

DataServiceQueryContinuation

DataServiceQueryContinuation<T> 物件，表示從資料服務傳回的下一頁相關實體資料。

callback

AsyncCallback

有結果可供用戶端使用時要叫用的方法。

state

Object

傳遞至回呼的使用者定義狀態物件。

傳回

IAsyncResult

IAsyncResult，表示作業的狀態。

備註

提供的 DataServiceQueryContinuation<T> 物件包含 URI，在執行時會在查詢結果中傳回下一頁資料。

BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)

透過使用提供的下一個連結 URI，以非同步方式從資料服務載入一頁相關實體。

public:
 IAsyncResult ^ BeginLoadProperty(System::Object ^ entity, System::String ^ propertyName, Uri ^ nextLinkUri, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginLoadProperty (object entity, string propertyName, Uri nextLinkUri, AsyncCallback callback, object state);

member this.BeginLoadProperty : obj * string * Uri * AsyncCallback * obj -> IAsyncResult

Public Function BeginLoadProperty (entity As Object, propertyName As String, nextLinkUri As Uri, callback As AsyncCallback, state As Object) As IAsyncResult

參數

entity

Object

包含要載入之屬性的實體。

propertyName

String

要載入的指定之實體的屬性名稱。

nextLinkUri

Uri

用於載入下一個結果頁的 URI。

callback

AsyncCallback

有結果可供用戶端使用時要叫用的方法。

state

Object

傳遞至回呼的使用者定義狀態物件。

傳回

IAsyncResult

用於追蹤非同步作業之狀態的 IAsyncResult 物件。

備註

當 entity 處於 Unchanged 或 Modified 狀態時，相關實體是以 Unchanged 狀態載入，而且實體之間的連結也是以 Unchanged 狀態建立。

當 entity 處於 Deleted 狀態時，相關實體是以 Unchanged 狀態載入，而實體之間的連結則是以 Deleted 狀態建立。