IVersioningPersonalizable.Load(IDictionary) メソッド

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

バージョン変更のためそのデータに対応する個人用に設定されたプロパティがない Web パーツ コントロールに、パーソナル化データを読み込みます。

public:
 void Load(System::Collections::IDictionary ^ unknownProperties);

public void Load (System.Collections.IDictionary unknownProperties);

abstract member Load : System.Collections.IDictionary -> unit

Public Sub Load (unknownProperties As IDictionary)

パラメーター

unknownProperties

IDictionary

コントロールに適用できなかったパーソナル化データのディクショナリ。

注釈

unknownPropertiesパラメーターには、コントロールに適用できなかった "User" スコープと "Shared" スコープの両方の不明なパーソナル化データのマージされた表現が含まれています。 ページがユーザー スコープで実行されている場合は、不明な共有スコープの値ではなく、不明なユーザー スコープの値が指定されます (使用可能な場合)。 この情報は一連の名前と値のペアとして格納されます。各名前は、コントロールで見つからなかったプロパティの文字列名であり、各値にはプロパティ値が含まれています。 コントロールの役割は、値を適切な型にキャストまたは変換し、さらに処理を実行することです (古いプロパティから新しいプロパティへのデータのマッピングなど)。

コントロールの状態が変化した場合は、 を呼び出す SetPersonalizationDirty 必要があります (継承されたメソッド、または から WebPart派生していないコントロールの場合はパブリック静的メソッド)。 コントロール自体が "ダーティ" としてマークされている場合、Web パーツ コントロール セットは、コントロールの "ダーティ" 状態に関係なく、コントロールからパーソナル化データを抽出し、パーソナル化ライフ サイクルの後半で基になるデータ ストアに保存し直します。 パラメーターの値 unknownProperties を処理した結果、コントロールの状態が変更された場合、コントロール自体を "ダーティ" としてマークする必要があります。

Web パーツ コントロールのインポート時に孤立したプロパティが検出された場合、このメソッドは自動的に呼び出されることに注意してください。