de la propiedad WebPart.SaveProperties
Obtiene o establece un valor que indica si las propiedades de un elemento Web han cambiado y deben almacenarse al final de la representación de páginas.
Espacio de nombres: Microsoft.SharePoint.WebPartPages
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
Protected Friend Property SaveProperties As Boolean
Get
Set
'Uso
Dim value As Boolean
value = Me.SaveProperties
Me.SaveProperties = value
protected internal bool SaveProperties { get; set; }
Valor de propiedad
Tipo: System.Boolean
true si las propiedades del elemento Web deben conservarse; en caso contrario, false.
Comentarios
La propiedad SaveProperties se establece inicialmente en false al principio de la representación de páginas. Esta propiedad es útil sólo durante la representación de páginas. Por ejemplo, esta propiedad no surte efecto cuando se obtiene acceso a un elemento Web a través del modelo de objetos.
La propiedad SaveProperties puede utilizarse para elementos Web cuando cambian sus propiedades después de que se representa en una página de elementos Web. Después de cambiar una propiedad, una clase de WebPart puede establecer la propiedad SaveProperties en true para especificar que se guardarán las propiedades cambiadas. Se lee el valor de la propiedad SaveProperties por la infraestructura de elementos Web después de que se produce el evento System.Web.UI.Control.UnLoad del elemento Web, en qué punto propiedad todos los valores son de consulta y almacenados en la base de datos de SharePoint. Si no se establece esta propiedad, las propiedades revertirán a sus valores originales la próxima vez que se crea una instancia del elemento Web.
El valor de la propiedad SaveProperties se omite a menos que activamente se va a representar un elemento Web. Por ejemplo, la creación de instancias de un nuevo elemento Web, cambiar un valor de la propiedad y a continuación, en configuración SaveProperties a true tiene ningún efecto. La propiedad SaveProperties debe usarse un elemento Web que se debe guardar una propiedad que ha cambiado después de que se están representando. Si se establece una propiedad externamente, es responsabilidad del agente externo de alguna guardar el elemento Web, o de forma explícita durante un ciclo de representación para establecer la propiedad SaveProperties en nombre del elemento Web.
Si la propiedad SaveProperties se establece en un elemento Web estático (un elemento Web que no se encuentra en una zona) o para un elemento Web donde el usuario no tiene permisos suficientes para guardar los cambios (por ejemplo, un usuario anónimo), se produce una excepción cuando se intenta guardar dicho elemento Web. Un elemento Web debe comprobar la propiedad Permissions antes de mostrar una interfaz de usuario para guardar los valores de propiedad y si se establece SaveProperties en true.
Para ver un ejemplo de código que proporciona un ejemplo de cómo utilizar la propiedad SaveProperties , consulte WebPart.