Compartir a través de


PersonalizationProvider.GetCountOfState Método

Definición

Cuando se reemplaza en una clase derivada, devuelve el número de filas del almacén de datos subyacente que existen dentro del ámbito especificado.

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public abstract int GetCountOfState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Parámetros

scope
PersonalizationScope

Una enumeración PersonalizationScope de la información de personalización que se va a consultar. Este valor no puede ser null.

query
PersonalizationStateQuery

Una clase PersonalizationStateQuery que contiene una consulta. Este valor puede ser null.

Devoluciones

El número de filas del almacén de datos subyacente que existen para el parámetro scope especificado.

Comentarios

Este método es la definición abstracta de un método administrativo para recuperar recuentos de datos de personalización. Las implementaciones derivadas deben seguir la lógica que se describe a continuación.

Este método pasa caracteres comodín de consulta al almacén de datos subyacente. La compatibilidad con caracteres comodín depende actualmente de cómo controla cada proveedor caracteres, como un asterisco (*), un símbolo de porcentaje (%), o un carácter de subrayado (_).

Normalmente, para los almacenes de datos compatibles con SQL, puede realizar una búsqueda con caracteres comodín en una ruta de acceso parcial con el carácter comodín que aparece al principio, el final o el medio del texto de la cadena de búsqueda en la PathToMatch propiedad . Por ejemplo, para buscar todas las rutas de acceso que comienzan por "~/vdir", la PathToMatch propiedad se establecería en "~/vdir%".

Del mismo modo, una búsqueda con caracteres comodín en un nombre de usuario parcial podría hacer que el carácter comodín aparezca en cualquier punto de la cadena de texto de la UsernameToMatch propiedad. Por ejemplo, para buscar todos los nombres de usuario que comienzan por "John", el UsernameToMatch parámetro tendría un aspecto similar a "John%".

Se aplican las restricciones de consulta siguientes:

  • Si solo scope se proporciona y query es null o todas las propiedades query de devuelven null o valores predeterminados, se cuentan todos los registros que coinciden con el parámetro indicado scope .

  • Si la PathToMatch propiedad no nulles , los registros contados también se filtran en función de las rutas de acceso que coincidan con el PathToMatch valor.

  • Si la UsernameToMatch propiedad no nulles , los registros contados también se filtran en función de los nombres de usuario que coincidan con el valor de la UsernameToMatch propiedad.

  • Si la UserInactiveSinceDate propiedad no es igual a MaxValue, los registros contados también se filtran para devolver solo los registros asociados a usuarios inactivos. La comparación incluye registros en los que la LastActivityDate propiedad es menor o igual que la UserInactiveSinceDate propiedad .

Tenga en cuenta que este método no valida las combinaciones de parámetros de consulta. Por ejemplo, el código puede solicitar un recuento de registros de estado de personalización asociados a un nombre de usuario específico en el ámbito compartido. Dado que los nombres de usuario no están asociados a la información compartida, el recuento devuelto sería cero.

Entre las combinaciones de parámetros que tienen la posibilidad de devolver un recuento distinto de cero se incluyen las siguientes:

Se aplica a