PersonalizationProvider.FindState メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

PersonalizationProvider.FindState メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

派生クラスでオーバーライドされると、スコープおよび固有のクエリパラメータに基づき 0 個以上の PersonalizationStateInfo 派生オブジェクトが含まれているコレクションを返します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public MustOverride Function
 FindState ( _
    scope As PersonalizationScope, _
    query As PersonalizationStateQuery, _
    pageIndex As Integer, _
    pageSize As Integer, _
    <OutAttribute> ByRef totalRecords As
 Integer _
) As PersonalizationStateInfoCollection

Visual Basic (使用法)

Dim instance As PersonalizationProvider
Dim scope As PersonalizationScope
Dim query As PersonalizationStateQuery
Dim pageIndex As Integer
Dim pageSize As Integer
Dim totalRecords As Integer
Dim returnValue As PersonalizationStateInfoCollection

returnValue = instance.FindState(scope, query, pageIndex, pageSize, totalRecords)

public abstract PersonalizationStateInfoCollection FindState (
    PersonalizationScope scope,
    PersonalizationStateQuery query,
    int pageIndex,
    int pageSize,
    out int totalRecords
)

C++

public:
virtual PersonalizationStateInfoCollection^ FindState (
    PersonalizationScope scope, 
    PersonalizationStateQuery^ query, 
    int pageIndex, 
    int pageSize, 
    [OutAttribute] int% totalRecords
) abstract

public abstract PersonalizationStateInfoCollection FindState (
    PersonalizationScope scope, 
    PersonalizationStateQuery query, 
    int pageIndex, 
    int pageSize, 
    /** @attribute OutAttribute() */ /** @ref */ int totalRecords
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

scope: クエリされるパーソナル化情報が存在する PersonalizationScope。この値を null 参照 (Visual Basic では Nothing) にすることはできません。

query: クエリを含んでいる PersonalizationStateQuery。この値は、null 参照 (Visual Basic では Nothing) の場合もあります。

pageIndex: クエリが開始される位置。

pageSize: 返されるレコードの数。

totalRecords: レコード数の合計。

戻り値
0 個以上の PersonalizationStateInfo 派生オブジェクトを含んでいる PersonalizationStateInfoCollection。

解説

このメソッドは、パーソナル化データを照会するための管理メソッドの抽象定義です。派生した実装は、次に説明する論理に従っている必要があります。

返される項目の集合は、pageIndex パラメータおよび pageSize パラメータによって制限されます。pageSize によって返されるレコード数が設定され、pageIndex によって返されるレコードが設定されます。たとえば、pageIndex が 0 で pageSize が 25 の場合は、最初の 25 件が返され、pageIndex が 1 で pageSize が 25 の場合は、26 件目から 50 件目までが返されます。すべてのレコードを取得する場合には、pageIndex に 0 を、pageSize に MaxValue を設定します。

PersonalizationStateInfo 派生オブジェクトは、Path プロパティおよび Username プロパティの組み合わせにより、どちらもアルファベットの昇順に並べ替えられて返されます。

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

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

同様に、部分的なユーザー名によるワイルドカード検索では、UsernameToMatch プロパティ内のテキスト文字列のあらゆる箇所にワイルドカード文字を指定できます。たとえば、"John" で始まるすべてのユーザー名を検索するには、UsernameToMatch パラメータは "John%" のようになります。

クエリに関して次の制約が適用されます。

scope だけが指定されていて、query が null 参照 (Visual Basic では Nothing) であるか query のすべてのプロパティが null 参照 (Visual Basic では Nothing) または既定値のいずれかを返す場合には、示された scope パラメータに一致するすべてのレコードが返されます。
PathToMatch プロパティが null 参照 (Visual Basic では Nothing) でない場合は、返されるレコードも PathToMatch の値に一致するパスに基づいてフィルタ処理されます。
UsernameToMatch プロパティが null 参照 (Visual Basic では Nothing) でない場合は、返されるレコードも UsernameToMatch プロパティ値に一致するユーザー名に基づいてフィルタ処理されます。
UserInactiveSinceDate プロパティが MaxValue と等しくない場合は、返されるレコードもフィルタ処理され、アクティブでないユーザーに関連付けられたレコードだけが返されます。この比較には、LastActivityDate プロパティが UserInactiveSinceDate プロパティ以下のレコードが含まれます。

このメソッドでは、クエリパラメータの組み合わせは検証されません。たとえば、コードで、共有スコープの特定のユーザー名に関連付けられたパーソナル化状態レコードのセットを要求できます。ユーザー名は共有情報に関連付けられていないため、返されるコレクションは空となります。

空ではないコレクションを返す可能性があるパラメータの組み合わせ例を以下に示します。

PathToMatch プロパティと組み合わせた Shared スコープ。
PathToMatch、UsernameToMatch、および UserInactiveSinceDate の各プロパティのいずれかまたはすべての値と組み合わせた User スコープ。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PersonalizationProvider クラス
PersonalizationProvider メンバ
System.Web.UI.WebControls.WebParts 名前空間

>> 「PersonalizationProvider.FindState メソッド」を含む用語の索引
PersonalizationProvider.FindState メソッドのページへのリンク


	© 2024 Microsoft.All rights reserved.

PersonalizationProvider.FindState メソッドとは？ わかりやすく解説

PersonalizationProvider.FindState メソッド

急上昇のことば

PersonalizationProvider.FindState メソッドとは？わかりやすく解説