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
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.
