WebPartPersonalization.Load 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í.
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.PersonalizationScopeProtected Overridable Function Load () As PersonalizationScopeDevoluciones
Instancia PersonalizationScope de para el elemento primario WebPartManager.
Excepciones
Se llama a este método cuando la personalización no está habilitada (Enabled es igual falsea ).
O bien
El valor de la Page propiedad para el asociado WebPartManager es null.
O bien
El valor de la Request propiedad en la WebPartManager instancia asociada Page del control es null.
Un proveedor se estableció explícitamente en el marcado de página o en la ProviderName propiedad y no se encontró 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 datos.
O bien
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 pudieron inicializar porque no se encontró 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 yLoadPersonalizationState se almacena dentro de la WebPartPersonalization instancia.
El proveedorDetermineInitialScope () determina el ámbito de personalización de la página/usuario/ámbito actual. Tenga en cuenta que el resultado de esta determinación puede ser diferente del valor de la InitialScope propiedad .
El valor de ámbito devuelto de este método se usa como valor para 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.
