PersonalizationAdministration.FindUserState メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したパラメーターに基づいて、ユーザー別パーソナル化状態情報のコレクションを返します。
オーバーロード
| FindUserState(String, String) |
ユーザー名およびページのパスに基づいて、ユーザー別パーソナル化状態情報のコレクションを返します。 |
| FindUserState(String, String, Int32, Int32, Int32) |
指定したパラメーターに基づいて、ユーザー別パーソナル化状態情報のコレクションを返します。 |
FindUserState(String, String)
ユーザー名およびページのパスに基づいて、ユーザー別パーソナル化状態情報のコレクションを返します。
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch);public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch);static member FindUserState : string * string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollectionPublic Shared Function FindUserState (pathToMatch As String, usernameToMatch As String) As PersonalizationStateInfoCollectionパラメーター
- pathToMatch
- String
一致させるページのパス。
- usernameToMatch
- String
ページに関連付けられたパーソナル化データを持つ、一致させるユーザー名。
戻り値
ユーザー別パーソナル化状態情報が格納された PersonalizationStateInfoCollection。
例外
トリムの前後で、pathToMatch または usernameToMatch が空の文字列 ("") です。
- または -
構成でパーソナル化プロバイダーに対して定義されたプロバイダーの種類が正しくありません。
- または -
いずれかのパラメーターの文字列の長さが 256 文字を超えています。
構成されたパーソナル化プロバイダーのインスタンスを作成し、初期化しようとした際に、構成の例外が発生しました。
- または -
構成で定義された既定のパーソナル化プロバイダーが見つかりません。
例
次のコード例は、FindUserState メソッドの使用方法を示します。 完全な例については、クラスの概要に関するトピックを PersonalizationAdministration 参照してください。
重要
この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。 詳細については、「スクリプトによる攻略の概要」を参照してください。
protected void Button1_Click(object sender, EventArgs e)
{
if (TextBox3.Text != null)
{
PersonalizationStateInfoCollection findresult;
findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
if (findresult.Count != 0)
{
Label4.Text = findresult.Count + " user(s) found";
Label4.Visible = true;
}
else
{
Label4.Text = "No users found.";
Label4.Visible = true;
}
}
else
{
Label4.Text = "You must enter a user name to find.";
}
}
注釈
このメソッドは、パラメーター値がpathToMatchページのUserPersonalizationStateInfoパスと一致し、そのページに関連付けられているパーソナル化データを持つユーザー名とusernameToMatch一致するインスタンスのコレクションを返します。 コレクションにはインスタンスのみが UserPersonalizationStateInfo 含まれます。
このメソッドは、パラメーターワイルドカード文字を基になるパーソナル化プロバイダーに渡します。そのため、データ ストアでこれらの文字を処理する方法は、プロバイダーがアスタリスク (*)、パーセント記号 (%)、アンダースコア (_) などの文字をどのように処理するかによって異なります。
通常、SQL 準拠のデータ ストアでは、ワイルドカード文字がプロパティ内の検索文字列テキストの先頭、末尾、または中央に表示される部分パスでワイルドカード検索を PathToMatch 実行できます。 たとえば、"~/vdir" で始まるすべてのパスを検索するには、 プロパティを PathToMatch "~/vdir%" に設定します。
同様に、部分的なユーザー名に対するワイルドカード検索では、 プロパティのテキスト文字列内の任意の時点でワイルドカード文字を UsernameToMatch 表示できます。 たとえば、"John" で始まるすべてのユーザー名を UsernameToMatch 検索するには、 プロパティは "John%" のようになります。
既定のパーソナル化プロバイダーを使用すると、 PersonalizationStateInfo派生オブジェクトはアルファベット順に返され、パスとユーザー名の組み合わせで昇順で並べ替えられます。 コレクション内のオブジェクトの順序は、プロバイダーによって決まります。
と のusernameToMatch両方pathToMatchを 指定nullできます。
usernameToMatch Microsoft SQL Server を実行するデータ ストアなど、一部のデータ ストアではコンマをワイルドカード文字として使用できるため、パラメーターにはコンマ (,) を指定できます。
こちらもご覧ください
- WebPartPersonalization
- ASP.NET Web パーツ コントロール
- Web パーツのパーソナル化の概要
- チュートリアル: ユーザー コントロールを使用した Web パーツのパーソナル化の実装
- Web パーツのパーソナル化
適用対象
FindUserState(String, String, Int32, Int32, Int32)
指定したパラメーターに基づいて、ユーザー別パーソナル化状態情報のコレクションを返します。
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);static member FindUserState : string * string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollectionPublic Shared Function FindUserState (pathToMatch As String, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollectionパラメーター
- pathToMatch
- String
一致させるページのパス。
- usernameToMatch
- String
ページに関連付けられたパーソナル化データを持つ、一致させるユーザー名。
- pageIndex
- Int32
取得する結果のページの 0 から始まるインデックス。
- pageSize
- Int32
返されるレコードの数です。
- totalRecords
- Int32
レコード数の合計。
戻り値
ユーザー別パーソナル化状態情報が格納された PersonalizationStateInfoCollection。
例外
トリムの前後で、pathToMatch または usernameToMatch が空の文字列 ("") です。
- または -
pageIndex が 0 未満です。
または
pageSize が 0 以下です。
- または -
と の組み合わせが Int32.MaxValue を超えています。pageIndexpageSize
- または -
構成でパーソナル化プロバイダーに対して定義されたプロバイダーの種類が正しくありません。
- または -
いずれかのパラメーターの文字列の長さが 256 文字を超えています。
構成されたパーソナル化プロバイダーのインスタンスを作成し、初期化しようとした際に、構成の例外が発生しました。
- または -
構成で定義された既定のパーソナル化プロバイダーが見つかりません。
例
次のコード例は、FindUserState メソッドの使用方法を示します。 完全な例については、クラスの概要に関するトピックを PersonalizationAdministration 参照してください。
重要
この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。 詳細については、「スクリプトによる攻略の概要」を参照してください。
protected void Button1_Click(object sender, EventArgs e)
{
if (TextBox3.Text != null)
{
PersonalizationStateInfoCollection findresult;
findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
if (findresult.Count != 0)
{
Label4.Text = findresult.Count + " user(s) found";
Label4.Visible = true;
}
else
{
Label4.Text = "No users found.";
Label4.Visible = true;
}
}
else
{
Label4.Text = "You must enter a user name to find.";
}
}
注釈
このメソッドは、パラメーター値がpathToMatchページのUserPersonalizationStateInfoパスと一致し、そのページに関連付けられているパーソナル化データを持つユーザー名とusernameToMatch一致するインスタンスのコレクションを返します。 コレクションにはインスタンスのみが UserPersonalizationStateInfo 含まれます。
このメソッドは、パラメーターワイルドカード文字を基になるパーソナル化プロバイダーに渡します。そのため、データ ストアでこれらの文字を処理する方法は、プロバイダーが文字をアスタリスク (*)、パーセント記号 (%)、またはアンダースコア (_) として処理する方法によって異なります。
通常、SQL 準拠のデータ ストアでは、ワイルドカード文字がプロパティ内の検索文字列テキストの先頭、末尾、または中央に表示される部分パスでワイルドカード検索を PathToMatch 実行できます。 たとえば、"~/vdir" で始まるすべてのパスを検索するには、 プロパティを PathToMatch "~/vdir%" に設定します。
同様に、部分的なユーザー名に対するワイルドカード検索では、 プロパティのテキスト文字列内の任意の時点でワイルドカード文字を UsernameToMatch 表示できます。 たとえば、"John" で始まるすべてのユーザー名を UsernameToMatch 検索するには、 プロパティは "John%" のようになります。
既定のパーソナル化プロバイダーを使用すると、 PersonalizationStateInfo派生オブジェクトはアルファベット順に返され、パスとユーザー名の組み合わせで昇順で並べ替えられます。 コレクション内のオブジェクトの順序は、プロバイダーによって決まります。
と のusernameToMatch両方pathToMatchを 指定nullできます。
usernameToMatch Microsoft SQL Server を実行するデータ ストアなど、一部のデータ ストアではコンマをワイルドカード文字として使用できるため、パラメーターにはコンマ (,) を指定できます。
返されるデータは、 と pageSizeによってpageIndex制限されます。ここでpageIndex、返すレコードを制御し、pageSize返すレコードの数を制御します。 たとえば、 が 0 に設定されpageSize、25 に設定されている場合pageIndex、返されるデータは最初の 25 エントリになります。 が 1 に設定され、pageSize25 に設定されている場合pageIndex、返されるデータはエントリ 26 から 50 になります。 パラメーターは totalRecords 、使用可能なレコードの合計数を返します。
こちらもご覧ください
- WebPartPersonalization
- ASP.NET Web パーツ コントロール
- Web パーツのパーソナル化の概要
- チュートリアル: ユーザー コントロールを使用した Web パーツのパーソナル化の実装
- Web パーツのパーソナル化
適用対象
.NET