SPMobileBaseFieldControl.PostValue - Propriété
Obtient la valeur que le champ aura après la prochaine publication de la page.
Espace de noms : Microsoft.SharePoint.Mobile.WebControls
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Overridable ReadOnly Property PostValue As Object
Get
'Utilisation
Dim instance As SPMobileBaseFieldControl
Dim value As Object
value = instance.PostValue
public virtual Object PostValue { get; }
Valeur de propriété
Type : System.Object
Un Object qui représente la valeur que le champ aura après la prochaine publication de la page.
Remarques
L'implémentation par défaut retourne la même valeur que celle qui se trouve dans Value et l'implémentation par défaut de la propriété cette dernière retourne la même valeur que ItemFieldValue.
Substituer l'accesseur degetPostValuelorsque le champ attend des valeurs dans un format spécial. Par exemple, si le champ attend des pourcentages, l'accesseur get doit diviser Value par 100.
Remarques destinées aux héritiers
Nous vous recommandons de mettre à jour la relation suivante entre les propriétés ItemFieldValue, Valueet PostValue et la méthode TrySaveFieldValue dans vos classes dérivées.
ItemFieldValue est la valeur du champ après le plus récent enregistré les modifications. Les modifications non enregistrées, si effectuées par l'utilisateur dans l'interface utilisateur ou par le code-behind, ne sont pas répercutées dans ItemFieldValue.
Value est généralement identique au ItemFieldValue immédiatement après chaque chargement d'une page ou une publication (postback), mais il peut être modifié. En général, la modification est effectuée par le biais de l'interface utilisateur et n'est pas enregistrée tant que l'utilisateur prenne des mesures supplémentaires, telles que le clic sur un contrôle d'Enregistrer . Avant l'enregistrement, Value et ItemFieldValue ont des valeurs différentes.
PostValue est identique à Value , dans la plupart des cas, mais il peut être utile lorsque les utilisateurs entrent des valeurs pour Value qui ne sont pas au format attendu par le champ. Utilisez PostValue pour contenir la version correctement mis en forme de la valeur. Par exemple, si le champ contient un pourcentage que les utilisateurs entrent en tant que nombres entiers, mais le champ nécessite que la valeur est une fraction de 1, PostValue peut être Value divisé par 100.
TrySaveFieldValue est appelé lorsqu'une modification apportée à un champ est en cours d'enregistrement, généralement dans le cadre d'une cuve d'itération tous les champs d'un élément de liste. Il écrit la valeur de PostValue à ItemFieldValue et Value.
Par exemple, supposons que le champ est une valeur Boolean et rendu sous la forme d'une case à cocher. Lorsque la page charge tout d'abord, ItemFieldValue est false et la case à cocher n'est pas activée**[.]** , que cela signifie que Value est également falseet n'est donc PostValue car il n'existe aucune mise en forme spéciale pour ce champ booléen. L'utilisateur clique sur la case à cocher et Value (et PostValue) deviennent des true. L'utilisateur clique sur un bouton Enregistrer et ItemFieldValue devient true.
Pour un autre exemple, supposons que le champ est un champ de texte dans laquelle les utilisateurs entrent un pourcentage sous la forme d'un nombre entier, mais pour lequel les valeurs sont stockées sous la forme d'une fraction de 1. Lorsque la page se charge pour la première fois, le ItemFieldValue, est de 0,15 et Value est 15. PostValue est de 0,15. L'utilisateur modifie le 15 à 40 et Value devient 40 PostValue devient 0.4. L'utilisateur clique sur un bouton Enregistrer et ItemFieldValue devient 0.4.
Voir aussi
Référence
SPMobileBaseFieldControl classe