PersonalizationAdministration.GetCountOfUserState(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したユーザーに存在している基になるデータ ストア内のパーソナル化状態項目の数を返します。
public:
static int GetCountOfUserState(System::String ^ usernameToMatch);public static int GetCountOfUserState (string usernameToMatch);static member GetCountOfUserState : string -> intPublic Shared Function GetCountOfUserState (usernameToMatch As String) As Integerパラメーター
- usernameToMatch
- String
取得するパーソナル化状態情報に関連付けられたユーザー名。
戻り値
指定したユーザーのパーソナル化状態項目の数。
例外
usernameToMatch は、トリムすると空の文字列 ("") になります。
- または -
構成でパーソナル化プロバイダーに対して定義されたプロバイダーの種類が正しくありません。
- または -
いずれかのパラメーターの文字列の長さが 256 文字を超えています。
構成されたパーソナル化プロバイダーのインスタンスを作成し、初期化しようとした際に、構成の例外が発生しました。
- または -
構成で定義された既定のパーソナル化プロバイダーが見つかりません。
既定のプロバイダーから負の数値が返されました。
注釈
このメソッドは、指定 usernameToMatchされた に存在する基になるデータ ストア内のユーザーごとの個人用設定項目の数を返します。
パラメーターにはワイルドカード文字を usernameToMatch 含めることができます。 このメソッドは、基になるデータ ストアにワイルドカード文字を渡します。 ワイルドカード文字のサポートは現在、各プロバイダーがアスタリスク (*)、パーセント記号 (%)、アンダースコア (_) などの文字を処理する方法によって異なります。
通常、SQL 準拠のデータ ストアの場合、部分的なユーザー名に対するワイルドカード検索では、 プロパティのテキスト文字列内の任意の時点でワイルドカード文字を UsernameToMatch 表示できます。 たとえば、"John" で始まるすべてのユーザー名を UsernameToMatch 見つけるには、 パラメーターは "John%" のようになります。
usernameToMatch パラメーターは、null に設定できます。 に設定すると null、クエリの実行時に パラメーターは無視されます。
usernameToMatch Microsoft SQL Server を実行しているデータ ストアなど、一部のデータ ストアではコンマをワイルドカード文字として使用できるため、パラメーターにはコンマ (,) を指定できます。
適用対象
こちらもご覧ください
.NET