SPMobileBaseFieldControl.Value - Propriété
Obtient ou définit la valeur du champ de l'élément actuel de la liste provisoire.
Espace de noms : Microsoft.SharePoint.Mobile.WebControls
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Overridable Property Value As Object
Get
Set
'Utilisation
Dim instance As SPMobileBaseFieldControl
Dim value As Object
value = instance.Value
instance.Value = value
public virtual Object Value { get; set; }
Valeur de propriété
Type : System.Object
Object qui représente la valeur du champ qui n'a pas nécessairement été enregistrée.
Remarques
Il n'y a aucune implémentation par défaut de l'accesseur de set .
L'implémentation par défaut retourne la même valeur que ItemFieldValue.
Remarques destinées aux héritiers
Si vous fournissez une implémentation pour l'accesseur de set , vous devez fournir une nouvelle implémentation de l'accesseur get ou il retournera toujours la valeur de ItemFieldValue au lieu de la valeur à laquelle la propriété a été définie.
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