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