次の方法で共有


PersonalizationAdministration.FindInactiveUserState メソッド

定義

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

オーバーロード

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

例外

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

- または -

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

- または -

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

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

- または -

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

注釈

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

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

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

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

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

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

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

こちらもご覧ください

適用対象

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

例外

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

- または -

pageIndex が 0 未満です。

- または -

pageSize が 0 以下です。

- または -

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

- または -

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

- または -

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

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

- または -

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

注釈

このメソッドはインスタンスのコレクションを返します。パラメーター値が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 、使用可能なレコードの合計数を返します。

こちらもご覧ください

適用対象