PersonalizationScope Enumeración

Definición

Espacio de nombres:

System.Web.UI.WebControls.WebParts

Ensamblado:

System.Web.dll

Indica el ámbito de personalización de un objeto WebPartManager o el ámbito de personalización que se aplica a una propiedad en un control de elementos web.

public enum class PersonalizationScope

public enum PersonalizationScope

type PersonalizationScope = 

Public Enum PersonalizationScope

Herencia

Object

ValueType

Enum

PersonalizationScope

Campos

Shared	1	Al hacer referencia al ámbito del control WebPartManager, el ámbito Shared significa que los datos de personalización se aplican a todos los usuarios y para todos los controles personalizables de una página, y que también están disponibles para guardarse en la página. Cuando se hace referencia al ámbito asociado con una propiedad de control de elementos web, el ámbito Shared indica que la propiedad normalmente solo permite cargar o guardar datos asociados con todos los usuarios.
User	0	Al hacer referencia al ámbito del control WebPartManager, el ámbito User indica que los datos de personalización específicos del usuario, así como los datos de personalización aplicables a todos los usuarios, se cargan para todos los controles personalizables de una página. Solo los datos de personalización específicos del usuario pueden guardarse en la página. Cuando se hace referencia al ámbito asociado con una propiedad de control de elementos web, el ámbito User indica que la propiedad solo puede cargar y almacenar datos aplicables a todos los usuarios cuando se ejecuta en una página en el ámbito Shared. Sin embargo, cuando el control de la propiedad se ejecuta en una página en User el ámbito, los datos por usuario y todos los usuarios de la propiedad se cargarán y combinarán. Sin embargo, en este caso, solo se guardarán los datos por usuario cuando una página se ejecute en User el ámbito de ámbito.

Ejemplos

En el ejemplo siguiente se muestra el uso de la PersonalizationScope enumeración :

if (_manager.Personalization.Scope == PersonalizationScope.Shared)
{
    TextBox2.Text = "Shared Scope";
}
else
    TextBox2.Text = "User Scope";

Comentarios

El ámbito de personalización es un concepto clave en la personalización de elementos web y está estrechamente integrado con otras configuraciones, incluido el ámbito en el que se ejecuta la página, a través del WebPartManager control , el ámbito asociado a cada propiedad de un control y la forma en que se agregó el control a la página. Para obtener más información sobre el ámbito de personalización, vea Información general sobre personalización de elementos web.

El ámbito de personalización hace referencia a cómo se aplican los datos de personalización a diferentes conjuntos de usuarios. Algunos datos de personalización son aplicables solo a un usuario y control específicos de una página. Otros datos de personalización son aplicables a todos los usuarios que ven un sitio. El ámbito de personalización se usa en varias áreas de personalización para indicar qué conjunto de datos se deben recuperar y mostrar.

Cuando una página se ejecuta en Shared el ámbito de personalización, esto indica que solo se deben cargar los datos de personalización de un control específico, aplicables a todos los usuarios que ven el control. En función de los derechos del usuario que se está ejecutando actualmente, estos datos ampliamente aplicables también se pueden modificar y guardar de nuevo en el almacén de datos. Cuando una página se ejecuta en User el ámbito de personalización, esto indica que los datos de personalización de un control se deben guardar y cargar en función del usuario que se está ejecutando actualmente. Normalmente, esto significa que los datos específicos del usuario se pueden cargar y guardar en un control, mientras que los datos ampliamente aplicables (o datos compartidos) solo se pueden ver en el control.

Un WebPartManager control, que administra el ciclo de vida de alto nivel de personalización, se ejecuta en uno de los dos ámbitos de personalización.