IVersioningPersonalizable.Load(IDictionary) メソッド

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

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

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