DataSourceProvider.InitialLoad メソッド

定義

基になるデータ モデルに対する最初のクエリを開始します。Starts the initial query to the underlying data model. 結果は Data プロパティに返されます。The result is returned on the Data property.

public:
 void InitialLoad();
public void InitialLoad ();
member this.InitialLoad : unit -> unit
Public Sub InitialLoad ()

注釈

このメソッドは、通常、依存データバインディングがアクティブになったときにバインディングエンジンによって呼び出されます。This method is typically called by the binding engine when dependent data bindings are activated. IsInitialLoadEnabled false データの自動読み込みを回避または遅延するには、をに設定します。Set IsInitialLoadEnabled to false to prevent or delay the automatic loading of data.

メソッドは、 InitialLoad 複数回呼び出すことができます。The InitialLoad method can be called multiple times. 最初のクエリの実行中にビジー状態になると、プロバイダーは後続の呼び出しを無視します。が再度呼び出された場合、プロバイダーは既に実行中のクエリを再起動しません InitialLoadThe provider ignores subsequent calls once it is busy executing the initial query; the provider does not restart an already running query when InitialLoad is called again. クエリが正常に終了した場合でも、すべての InitialLoad 呼び出しでデータが再クエリされることはありません。When the query finishes successfully, any InitialLoad call still does not re-query data. InitialLoad通常、操作は非同期であり、 DataChanged プロパティが Data 新しい値を想定したときにイベントが発生します。The InitialLoad operation is typically asynchronous, a DataChanged event is raised when the Data property assumed a new value.

アプリケーションがを呼び出すと、 Refresh データが更新されます。The application calls Refresh to cause a refresh of the data.

適用対象