SqlPersonalizationProvider.GetCountOfState Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls.WebParts
Ensamblado:
System.Web.dll

Devuelve un recuento del número de filas del almacén de datos subyacente que existe para el parámetro scope especificado.

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

Parámetros

scope
PersonalizationScope

Un objeto PersonalizationScope que indica la información de personalización que se consulta. Este valor no puede ser null.

query
PersonalizationStateQuery

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

Devoluciones

Int32

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

Excepciones

ArgumentException

El valor de la propiedad PathToMatch no es null y es una cadena vacía ("") después de su recorte.

o bien

La longitud de PathToMatch es mayor de 256 caracteres cuando el valor no es null.

o bien

El valor de la propiedad UsernameToMatch no es null y es una cadena vacía después de su recorte.

o bien

La longitud de UsernameToMatch es mayor de 256 caracteres cuando el valor no es null.

ArgumentOutOfRangeException

El elemento scope especificado no es un valor válido de la enumeración PersonalizationScope.

Comentarios

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 "~/approot", la PathToMatch propiedad se establecería en "~/approot%".

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 devuelven todos los registros que coinciden con el parámetro indicado scope .

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

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

  • Si la UserInactiveSinceDate propiedad no es igual a MaxValue, los registros devueltos 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 asociados a usuarios inactivos en el ámbito compartido. Dado que no hay ningún concepto de personalizaciones inactivas, el recuento devuelto sería cero.

Las combinaciones de parámetros que tienen la posibilidad de devolver una colección no vacía incluyen:

Se aplica a