PersonalizationAdministration.FindInactiveUserState メソッド

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

指定したパラメーターに基づいて、アクティブでないユーザーのユーザー別パーソナル化状態情報のコレクションを返します。

オーバーロード

FindInactiveUserState(String, String, DateTime)	指定したパラメーターに基づいて、アクティブでないユーザーのユーザー別パーソナル化状態情報のコレクションを返します。
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)	指定したパラメーターに基づいて、アクティブでないユーザーのユーザー別パーソナル化状態情報のコレクションを返します。

FindInactiveUserState(String, String, DateTime)

指定したパラメーターに基づいて、アクティブでないユーザーのユーザー別パーソナル化状態情報のコレクションを返します。

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);

public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);

static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection

パラメーター

pathToMatch

String

一致させるページのパス。

usernameToMatch

String

ページに関連付けられたパーソナル化データを持つ、一致させるユーザー名。

userInactiveSinceDate

DateTime

ユーザーのパーソナル化情報がアクセスされた最新の日付。

戻り値

PersonalizationStateInfoCollection

ユーザー別パーソナル化状態情報が格納された PersonalizationStateInfoCollection。

例外

ArgumentException

トリムの前後で、pathToMatch または usernameToMatch が空の文字列 ("") です。

- または -

構成でパーソナル化プロバイダーに対して定義されたプロバイダーの種類が正しくありません。

- または -

いずれかのパラメーターの文字列の長さが 256 文字を超えています。

ConfigurationErrorsException

構成されたパーソナル化プロバイダーのインスタンスを作成し、初期化しようとした際に、構成の例外が発生しました。

- または -

構成で定義された既定のパーソナル化プロバイダーが見つかりません。

注釈

このメソッドはインスタンスのコレクションを返します。パラメーター値がpathToMatchページのUserPersonalizationStateInfoパスと一致し、usernameToMatchそのページに関連付けられたパーソナル化データを持つユーザー名と一致し、ユーザーは非アクティブと見なされます。 つまり、返されるレコードごとに、ユーザーの LastActivityDate プロパティ値が 以下 userInactiveSinceDateになります。 返されるコレクションにはインスタンスのみが UserPersonalizationStateInfo 含まれます。

このメソッドは、基になるデータ ストアにクエリ ワイルドカード文字を渡します。 ワイルドカード文字のサポートは現在、各プロバイダーがアスタリスク (*)、パーセント記号 (%)、アンダースコア (_) などの文字を処理する方法によって異なります。

通常、SQL 準拠のデータ ストアでは、ワイルドカード文字がプロパティ内の検索文字列テキストの先頭、末尾、または中央に表示される部分パスでワイルドカード検索を PathToMatch 実行できます。 たとえば、"~/vdir" で始まるすべてのパスを検索するには、 プロパティを PathToMatch "~/vdir%" に設定します。

同様に、部分的なユーザー名に対するワイルドカード検索では、 プロパティのテキスト文字列内の任意の時点でワイルドカード文字を UsernameToMatch 表示できます。 たとえば、"John" で始まるすべてのユーザー名を UsernameToMatch 検索するには、 プロパティは "John%" のようになります。

既定のパーソナル化プロバイダーを使用すると、 PersonalizationStateInfo派生オブジェクトはアルファベット順に返され、パスとユーザー名の組み合わせで昇順で並べ替えられます。 コレクション内のオブジェクトの順序は、プロバイダーによって決まります。

が MaxValueの場合userInactiveSinceDate、このメソッドから返される値は とFindUserState同じです。

と のusernameToMatch両方pathToMatchを 指定nullできます。 usernameToMatch Microsoft SQL Server を実行するデータ ストアなど、一部のデータ ストアではコンマをワイルドカード文字として使用できるため、パラメーターにはコンマ (,) を含めることができます。

こちらもご覧ください

• WebPartPersonalization
• ASP.NET Web パーツ コントロール
• Web パーツのパーソナル化の概要
• チュートリアル: ユーザー コントロールを使用した Web パーツのパーソナル化の実装
• Web パーツのパーソナル化

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

指定したパラメーターに基づいて、アクティブでないユーザーのユーザー別パーソナル化状態情報のコレクションを返します。

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);

static member FindInactiveUserState : string * string * DateTime * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

パラメーター

pathToMatch

String

一致させるページのパス。

usernameToMatch

String

ページに関連付けられたパーソナル化データを持つ、一致させるユーザー名。

userInactiveSinceDate

DateTime

パーソナル化情報がアクセスされた最新の日付。

pageIndex

Int32

取得する結果のページの 0 から始まるインデックス。

pageSize

Int32

返されるレコードの数です。

totalRecords

Int32

レコード数の合計。

戻り値

PersonalizationStateInfoCollection

ユーザー別パーソナル化状態情報が格納された PersonalizationStateInfoCollection。

例外

ArgumentException

トリムの前後で、pathToMatch または usernameToMatch が空の文字列 ("") です。

- または -

pageIndex が 0 未満です。

- または -

pageSize が 0 以下です。

- または -

と の組み合わせが Int32.MaxValue を超えています。pageIndexpageSize

- または -

構成でパーソナル化プロバイダーに対して定義されたプロバイダーの種類が正しくありません。

- または -

いずれかのパラメーターの文字列の長さが 256 文字を超えています。

ConfigurationErrorsException

構成されたパーソナル化プロバイダーのインスタンスを作成し、初期化しようとした際に、構成の例外が発生しました。

- または -

構成で定義された既定のパーソナル化プロバイダーが見つかりません。

注釈

このメソッドはインスタンスのコレクションを返します。パラメーター値がpathToMatchページのUserPersonalizationStateInfoパスと一致し、usernameToMatchそのページに関連付けられたパーソナル化データを持つユーザー名と一致し、ユーザーは非アクティブと見なされます。 つまり、返されるレコードごとに、ユーザーの LastActivityDate プロパティ値が 以下 userInactiveSinceDateになります。 コレクションにはインスタンスのみが UserPersonalizationStateInfo 含まれます。

このメソッドは、パラメーターワイルドカード文字を基になるパーソナル化プロバイダーに渡します。そのため、データ ストアでこれらの文字を処理する方法は、プロバイダーがアスタリスク (*)、パーセント記号 (%)、アンダースコア (_) などの文字をどのように処理するかによって異なります。

通常、SQL 準拠のデータ ストアでは、ワイルドカード文字がプロパティ内の検索文字列テキストの先頭、末尾、または中央に表示される部分パスでワイルドカード検索を PathToMatch 実行できます。 たとえば、"~/vdir" で始まるすべてのパスを検索するには、 プロパティを PathToMatch "~/vdir%" に設定します。

同様に、部分的なユーザー名に対するワイルドカード検索では、 プロパティのテキスト文字列内の任意の時点でワイルドカード文字を UsernameToMatch 表示できます。 たとえば、"John" で始まるすべてのユーザー名を UsernameToMatch 検索するには、 プロパティは "John%" のようになります。

既定のパーソナル化プロバイダーを使用すると、 PersonalizationStateInfo派生オブジェクトはアルファベット順に返され、パスとユーザー名の組み合わせで昇順で並べ替えられます。 コレクション内のオブジェクトの順序は、プロバイダーによって決まります。

が MaxValueの場合userInactiveSinceDate、このメソッドから返される値は とFindUserState同じです。

と の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 パーツのパーソナル化