WebPart.SaveProperties property
Obtém ou define um valor que indica se as propriedades de uma Web Part foram alteradas e devem ser mantidas no final de renderização de página.
Namespace: Microsoft.SharePoint.WebPartPages
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
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; }
Property value
Type: System.Boolean
true se as propriedades de Web Part devem ser mantidas; Caso contrário, false.
Comentários
A propriedade SaveProperties é definida inicialmente para false no início de renderização de página. Essa propriedade é útil apenas durante a renderização de página. Por exemplo, esta propriedade não tem efeito quando uma Web Part é acessada através do modelo de objeto.
A propriedade SaveProperties pode ser usada para Web Parts quando suas propriedades são alteradas após sendo processados em uma página de Web Parts. Depois que uma propriedade for alterada, uma classe WebPart pode definir a propriedade de SaveProperties para true para especificar que todas as propriedades alteradas serão salvas. O valor da propriedade SaveProperties é lido pela infra-estrutura de Web Part depois ocorrerá o evento System.Web.UI.Control.UnLoad da Web Part, no momento em que a propriedade todos os valores são consultados e armazenados no banco de dados do SharePoint. Se essa propriedade não estiver definida, as propriedades reverter para seus valores originais na próxima vez em que a Web Part é instanciada.
O valor da propriedade SaveProperties será ignorado, a menos que uma Web Part ativamente está sendo processada. Por exemplo, uma instância de uma nova Web Part, alterando um valor da propriedade e, em seguida, configuração SaveProperties para true não tem efeito. A propriedade SaveProperties deve ser usada por uma Web Part que precisa para salvar uma propriedade que foi alterado após está sendo processado. Se uma propriedade for definida externamente, é responsabilidade do agente externo para uma salvar a Web Part explicitamente ou durante um ciclo de renderização para definir a propriedade SaveProperties em nome de Web Part.
Se a propriedade SaveProperties estiver definida em uma Web Part estática (uma Web Part que não esteja localizado em uma zona) ou para uma Web Part em que o usuário não tem permissões suficientes para salvar as alterações (como um usuário anônimo), uma exceção é acionada quando é feita uma tentativa para salvar essa Web Part. Uma Web Part deve verificar a propriedade Permissions antes de exibir uma interface de usuário para salvar os valores de propriedade e a definição de SaveProperties como true.
Para ver um exemplo de código que fornece um exemplo de como usar a propriedade SaveProperties , consulte WebPart.