SPMobileBaseFieldControl.TrySaveFieldValue - Méthode
Enregistre la nouvelle valeur pour le champ de la propriété PostValue .
Espace de noms : Microsoft.SharePoint.Mobile.WebControls
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Overridable Function TrySaveFieldValue As Boolean
'Utilisation
Dim instance As SPMobileBaseFieldControl
Dim returnValue As Boolean
returnValue = instance.TrySaveFieldValue()
public virtual bool TrySaveFieldValue()
Valeur renvoyée
Type : System.Boolean
true si la sauvegarde réussit ; dans le cas contraire, false.
Remarques
Dans l'implémentation par défaut, l'opération échoue si ReadOnly() est true.
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