SPMobileBaseFieldControl.PostValue property
Obtém o valor que o campo terá após o próximo postback da página.
Namespace: Microsoft.SharePoint.Mobile.WebControls
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
Public Overridable ReadOnly Property PostValue As Object
Get
'Uso
Dim instance As SPMobileBaseFieldControl
Dim value As Object
value = instance.PostValue
public virtual Object PostValue { get; }
Property value
Type: System.Object
Um Object que representa o valor que o campo terá após o próximo postback da página.
Comentários
A implementação padrão retorna o mesmo valor que está no Value e implementação do padrão da última propriedade retorna o mesmo valor como ItemFieldValue.
Substitua o acessador deget de PostValuequando o campo espera valores em um formato especial. Por exemplo, se o campo espera porcentagens, o acessador de get deve dividir Value por 100.
Notes to inheritors
Recomendamos que você mantenha a seguinte relação entre as propriedades ItemFieldValue, Valuee PostValue e o método TrySaveFieldValue em suas classes derivadas.
ItemFieldValue é o valor do campo após a mais recente salva a alteração. As alterações não salvas, se feita pelo usuário na interface do usuário ou por code-behind, não são refletidas no ItemFieldValue.
Value geral é idêntico ao ItemFieldValue imediatamente após cada carregamento de uma página ou uma nova postagem, mas ela pode ser alterada. Normalmente, a alteração é feita por meio da interface do usuário e não será salvo até que o usuário executa uma ação adicional, como clicar em um controle de Salvar . Antes de salvar, Value e ItemFieldValue têm valores diferentes.
PostValue é idêntico ao Value na maioria dos casos, mas pode ser útil quando os usuários estão inserindo valores para Value que não estão no formato esperado pelo campo. Use PostValue para manter a versão corretamente formatada do valor. Por exemplo, se o campo contém um percentual que os usuários são inseridos como números inteiros, mas o campo requer que o valor seja uma fração de 1, PostValue poderia ser Value dividido por 100.
TrySaveFieldValue é chamado quando uma alteração em um campo está sendo salvo, geralmente como parte de uma trough de iteração todos os campos de um item da lista. Ele grava o valor de PostValue para ItemFieldValue e Value.
Por exemplo, suponha que o campo é booleano e processada como uma caixa de seleção. Quando a página for carregada pela primeira vez, ItemFieldValue é false e a caixa de seleção não estiver marcada,[.] , que isso significa que Value também é falsee portanto é PostValue porque não há nenhuma formatação especial para esse campo booleano. O usuário clica a caixa de seleção e Value (e PostValue) tornam-se true. O usuário clica em um botão Salvar e ItemFieldValue torna-se true.
Um segundo exemplo, suponha que o campo é um campo de texto na qual os usuários inserem uma porcentagem como um número inteiro, mas para o quais os valores são armazenados como uma fração de 1. Quando a página for carregada pela primeira vez, o ItemFieldValue, é 0,15 e Value é 15. PostValue é 0,15. O usuário altera a 15 a 40 e 40 se torna Value e PostValue se torna 0.4. O usuário clica em um botão Salvar e ItemFieldValue se torna 0.4.
Ver também
Referência
SPMobileBaseFieldControl class