SqlPersonalizationProvider.ResetState Método

Definición

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

Elimina la información de estado de personalización del almacén de datos subyacente, en función de los parámetros especificados.

public:
 override int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, cli::array <System::String ^> ^ paths, cli::array <System::String ^> ^ usernames);
public override int ResetState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, string[] paths, string[] usernames);
override this.ResetState : System.Web.UI.WebControls.WebParts.PersonalizationScope * string[] * string[] -> int
Public Overrides Function ResetState (scope As PersonalizationScope, paths As String(), usernames As String()) As Integer

Parámetros

scope
PersonalizationScope

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

paths
String[]

Rutas de acceso para la información de personalización en el Shared ámbito que se va a eliminar.

usernames
String[]

Nombres de usuario para la información de personalización en el User ámbito que se va a eliminar.

Devoluciones

Int32

Número de filas eliminadas.

Excepciones

ArgumentException

paths El parámetro o usernames es una matriz vacía.

O bien

Los paths parámetros y usernames contenidos en las matrices respectivas no cumplen las reglas de validación.

ArgumentOutOfRangeException

El scope especificado no es un miembro de la PersonalizationScope enumeración.

Comentarios

Este método no admite caracteres comodín.

Solo se permiten las siguientes combinaciones de parámetros:

  • El scope parámetro se establece y todos los demás parámetros se establecen en null. Esta combinación elimina todos los datos de personalización de elementos web asociados al ámbito de personalización indicado por scope.

  • El scope parámetro se establece y el paths parámetro contiene al menos un valor. Esta combinación elimina todos los datos de personalización de elementos web de la ruta de acceso o rutas de acceso especificadas que se encuentran en el ámbito de personalización indicado por scope.

  • El scope parámetro se establece Useren , el paths parámetro se establece y solo contiene una ruta de acceso y el usernames parámetro contiene al menos un valor. Esta combinación elimina todos los datos de elementos web de personalización de usuario de la ruta de acceso especificada asociada al usuario o a los usuarios contenidos en usernames.

  • El scope parámetro se establece Useren , el paths parámetro es nully el usernames parámetro contiene al menos un valor. Esta combinación elimina todos los datos de elementos web de personalización por usuario, en todas las rutas de acceso, asociadas al usuario o a los usuarios contenidos en usernames.

Cualquier otra combinación de valores de parámetro no es válida y producirá una ArgumentException excepción. Por ejemplo, no se permiten las dos combinaciones siguientes:

  • No usernames se puede proporcionar el parámetro cuando el scope parámetro está establecido en Shared.

  • El paths parámetro no puede contener más de una entrada cuando el usernames parámetro no nulles .

Los paths parámetros y usernames contenidos en las matrices respectivas deben cumplir las siguientes reglas de validación. Si se produce un error en alguna regla de validación para cualquier miembro de las matrices de parámetros, se produce una ArgumentException excepción. Las reglas de validación incluyen:

  • null no se permiten valores.

  • No se permite una cadena vacía ("") después de recortar la cadena.

  • Ningún nombre de usuario incluido en el usernames parámetro puede contener comas.

  • La longitud de cualquier ruta de acceso del paths parámetro no puede tener más de 256 caracteres.

  • La longitud de cualquier nombre de usuario del usernames parámetro no puede tener más de 256 caracteres.

Se aplica a