Sys.Services ProfileService の load メソッド
更新 : 2007 年 11 月
指定したプロファイル プロパティを読み込みます。
Sys.Services.ProfileService.load(propertyNames, loadCompletedCallback, failedCallback, userContext);
パラメータ
パラメータ |
説明 |
---|---|
propertyNames |
読み込むプロファイル プロパティを含む文字列配列。 |
loadCompletedCallback |
読み込みが完了すると呼び出される関数。既定値は null です。 |
failedCallback |
読み込みが失敗すると呼び出される関数。既定値は null です。 |
userContext |
コールバック関数に渡されるユーザー コンテキスト情報。 |
解説
propertyNames の指定がない場合は、読み込みアクセス可能なプロファイル プロパティがサーバーから読み込まれます。読み込まれたプロファイルは、properties フィールドから直接アクセスできます。これにより、アプリケーションで、次の例に示すような簡単なフィールド構文を使用して、プロファイル プロパティにアクセスできます。
Sys.Services.ProfileService.properties.FieldName;
プロファイル サービスの呼び出しが失敗した場合は、defaultFailedCallback プロパティに指定された関数が呼び出されます。呼び出しが成功した場合は、defaultLoadCompletedCallback プロパティに指定された関数が呼び出されます。
使用例
現在認証されているユーザーのプロファイルを load メソッドを使用して読み込む方法を次の例に示します。このコードは、Sys.Services.ProfileService クラスの概要で説明しているコード例の一部です。
Sys.Services.ProfileService.load(null,
LoadCompletedCallback, ProfileFailedCallback, null);