DataServiceContext.BeginLoadProperty メソッド

定義

指定したプロパティの値をデータ サービスから読み込む操作を開始します。

オーバーロード

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

注釈

このメソッドを呼び出すと、プロパティ値を取得するネットワーク操作が呼び出されます。 関連付けやリンクを表すプロパティを含め、エンティティのどのプロパティでも指定できます。 プロパティが関連付け、リンク、または遅延プロパティを表す場合、このメソッドを呼び出すと、関連リソースを遅延読み込みする方法がクライアントに提供されます。 エンティティが変更状態にある場合は、プロパティ値は関連エンティティを読み込み、それらのエンティティとリンクを変更なしとマークします。

プロパティが既に読み込まれている場合は、このメソッドを呼び出すことによって、そのプロパティの値を更新できます。

適用対象

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

注釈

指定された 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 オブジェクト。

注釈

entity の状態が Unchanged または Modified の場合、関連エンティティは Unchanged 状態で読み込まれ、エンティティ間のリンクも Unchanged 状態で作成されます。

entity の状態が Deleted の場合、関連エンティティは Unchanged 状態で読み込まれ、エンティティ間のリンクは Deleted 状態で作成されます。

適用対象