Share via


WebPartPersonalization.Load Método

Definición

Inicializa la personalización.

protected:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationScope Load();
protected virtual System.Web.UI.WebControls.WebParts.PersonalizationScope Load ();
abstract member Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
Protected Overridable Function Load () As PersonalizationScope

Devoluciones

Una instancia PersonalizationScope para el objeto WebPartManager primario.

Excepciones

Se llama a este método cuando la personalización no está habilitada (Enabled es igual a false).

o bien

El valor de la propiedad Page para el objeto WebPartManager asociado es null.

o bien

El valor de la propiedad Request en la instancia WebPartManager asociada del control Page es null.

Se estableció explícitamente un proveedor en el marcado de la página o no se pudo encontrar la propiedad ProviderName y el proveedor.

o bien

El objeto que contiene los datos de estado de personalización es null.

Se produjo un problema al cargar y deserializar los datos.

o bien

Se produjo un error en la definición de un proveedor de personalización en el archivo de configuración.

Los proveedores de personalización subyacentes no se inicializaron porque no se pudo encontrar un proveedor predeterminado o porque se produjo un error al intentar inicializar un proveedor de personalización.

Comentarios

Este es el punto de entrada principal para inicializar información de personalización en nombre del control primario WebPartManager . Se llama a este método durante el método del OnInit control primarioWebPartManager. Normalmente, si la personalización se ha deshabilitado en el control primario WebPartManager , nunca se llamará a este método.

Durante el transcurso de este método, se producen las siguientes inicializaciones:

  • Se obtiene una referencia al proveedor de personalización predeterminado o al proveedor personalizado indicado en el WebPartManager marcado de página o la ProviderName propiedad .

  • Se llama al proveedor para determinar las funcionalidades del usuario (DetermineUserCapabilities) para el usuario que se está ejecutando actualmente.

  • El proveedor () carga el estado de personalización de la combinación actual de página, usuario o ámbito desde el almacén de datos subyacente (LoadPersonalizationState) y se almacena dentro de la WebPartPersonalization instancia.

  • El proveedorDetermineInitialScope () determina el ámbito de personalización de la página, el usuario o el ámbito actual. Tenga en cuenta que el resultado de esta determinación puede ser diferente al valor de la InitialScope propiedad .

El valor de ámbito devuelto por este método se usa como valor de la Scope propiedad .

Nota:

Una InvalidOperationException excepción debido a que no se habilita la personalización solo se producirá si se llama directamente al Load método . En la implementación de ASP.NET, se llama realmente a un método auxiliar interno para realizar la carga y este método auxiliar devuelve silenciosamente si no se ha habilitado la personalización para la página.

Se aplica a

Consulte también