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 状態で作成されます。