ITrackingPersonalizable.BeginLoad メソッド

定義

パーソナル化情報の読み込みフェーズの開始を表します。

public:
 void BeginLoad();
public void BeginLoad();
abstract member BeginLoad : unit -> unit
Public Sub BeginLoad ()

次のコード例では、 BeginLoad メソッドの使用方法を示します。 コントロールと.aspx ページで構成される完全で動作するコード例については、 IPersonalizable クラスの概要に関するトピックを参照してください。

void ITrackingPersonalizable.BeginLoad()
{
    _loading = true;
    _trackingLog = "1. BeginLoad\r\n";
}
Sub BeginLoad() Implements ITrackingPersonalizable.BeginLoad
    _loading = True
    _trackingLog = "1. BeginLoad" + vbCr + vbLf

End Sub

注釈

Web パーツ コントロール セットは、パーソナル化データを適用する前にこのメソッドを呼び出します。 独自の変更状態を追跡するコントロールでは、このメソッドを使用して、プロパティが SetPersonalizationDirtyを呼び出してはならないことを示す内部フラグを設定する必要があります。 これは、パーソナル化データの適用中に、 BeginLoadの呼び出しに続いてプロパティ設定メソッドを呼び出すことができるためです。 ほとんどのシナリオでは、基になるデータ ストアから読み込まれたデータに基づいてカスタマイズ可能なプロパティが設定されているからといって、コントロールを変更 ("ダーティ") と見なすべきではありません。

Note

このメソッドは、Web パーツ コントロールのインポート後にパーソナル化データが適用されるときにも呼び出されます。

適用対象