SqlPersonalizationProvider.GetCountOfState メソッド

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

SqlPersonalizationProvider.GetCountOfState メソッド

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

指定した scope パラメータに存在する、基になるデータ ストア内の行数の合計を返します。

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

Visual Basic (宣言)

Public Overrides Function
 GetCountOfState ( _
    scope As PersonalizationScope, _
    query As PersonalizationStateQuery _
) As Integer

Visual Basic (使用法)

Dim instance As SqlPersonalizationProvider
Dim scope As PersonalizationScope
Dim query As PersonalizationStateQuery
Dim returnValue As Integer

returnValue = instance.GetCountOfState(scope, query)

C#

public override int GetCountOfState (
    PersonalizationScope scope,
    PersonalizationStateQuery query
)

C++

public:
virtual int GetCountOfState (
    PersonalizationScope scope, 
    PersonalizationStateQuery^ query
) override

J#

public int GetCountOfState (
    PersonalizationScope scope, 
    PersonalizationStateQuery query
)

JScript

public override function GetCountOfState (
    scope : PersonalizationScope, 
    query : PersonalizationStateQuery
) : int

パラメータ

scope

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

query

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

戻り値
指定した scope パラメータに存在する、基になるデータ ストア内の行数。

例外

例外の種類	条件
ArgumentException	トリム後の PathToMatch が、null 参照 (Visual Basic では Nothing) 以外の空の文字列 ("") です。 または 値が null 参照 (Visual Basic では Nothing) 以外の場合、PathToMatch の長さが 256 文字を超えています。 または トリム後の UsernameToMatch が、null 参照 (Visual Basic では Nothing) 以外の空の文字列です。 または 値が null 参照 (Visual Basic では Nothing) 以外の場合、UsernameToMatch の長さが 256 文字を超えています。
ArgumentOutOfRangeException	指定された scope が、無効な PersonalizationScope 列挙値です。

解説

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

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

同様に、部分的なユーザー名によるワイルドカード検索では、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 プロパティ以下のレコードが含まれます。

このメソッドでは、クエリ パラメータの組み合わせは検証されません。たとえば、コードで、共有スコープのアクティブでないユーザーに関連付けられた状態レコードの数を要求できます。アクティブでない場合のカスタマイズは想定されていないため、返される数は 0 になります。

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

• PathToMatch と組み合わせた Shared スコープ。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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