SqlPersonalizationProvider.ResetState Método

Definición

Espacio de nombres:

System.Web.UI.WebControls.WebParts

Ensamblado:

System.Web.dll

Elimina información de estado de personalización del almacén de datos subyacente, basándose en 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

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

paths

String[]

Las rutas de acceso de la información de personalización en el ámbito Shared que se van a eliminar.

usernames

String[]

Los nombres de usuario para la información de personalización en el ámbito User que se van a eliminar.

Devoluciones

Int32

Número de filas eliminadas.

Excepciones

ArgumentException

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

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

ArgumentOutOfRangeException

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

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 para 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 en User, 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 en User, 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 se establece 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 las reglas 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.