SqlPersonalizationProvider.GetCountOfState Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> intPublic Overrides Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As IntegerParámetros
- scope
- PersonalizationScope
Un objeto PersonalizationScope que indica la información de personalización que se consulta. Este valor no puede ser null.
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.
Excepciones
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.
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
scopese proporciona yqueryesnullo todas las propiedadesqueryde devuelvennullo valores predeterminados, se devuelven todos los registros que coinciden con el parámetro indicadoscope.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 UsernameToMatch
nulles , 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:
Shared ámbito en combinación con PathToMatch.
User ámbito en combinación con los valores de cualquiera o todas las PathToMatchpropiedades , UsernameToMatchy UserInactiveSinceDate .
