SPFieldCalculated - Classe

Article
05/12/2015

Représente un champ calculé dans une liste.

Hiérarchie d’héritage

System.Object
Microsoft.SharePoint.SPField
Microsoft.SharePoint.SPFieldCalculated

Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Class SPFieldCalculated _
    Inherits SPField
'Utilisation
Dim instance As SPFieldCalculated

public class SPFieldCalculated : SPField

Remarques

Si vous définissez les propriétés de la classe SPFieldCalculated , vous devez appeler la méthode Update pour que les modifications soient prises en compte dans la base de données.

La propriété Formula permet de mettre en œuvre une formule dans un champ calculé. Pour plus d'informations sur les différents types de formules que vous pouvez utiliser, consultez Calculated Field Formulas.

Notes

Windows SharePoint Services 3.0 ne gère pas l'héritage de cette classe.

Exemples

L'exemple suivant crée un champ calculé dans une liste et l'ajoute à une vue. Le champ calculé affiche « Oui » si la valeur de MyColumn2 est supérieure à MyColumn1.

Dim webSite As SPWeb = SPContext.Current.Site.AllWebs("MyWebSite")
Try
    Dim list As SPList = webSite.Lists("MyList")
    Dim fields As SPFieldCollection = list.Fields

    Dim newFieldName As String = fields.Add("MyNewColumn", SPFieldType.Calculated, False)
    Dim newField As SPFieldCalculated = CType(fields(newFieldName), SPFieldCalculated)
    newField.Formula = "=[MyColumn1]<[MyColumn2]"
    newField.Update()

    Dim view As SPView = list.Views("MyView")
    Dim viewFields As SPViewFieldCollection = view.ViewFields
    viewFields.Add(newFieldName)
    view.Update()
Finally
    webSite.Dispose()
End Try

using (SPWeb oWebsite = SPContext.Current.Site.AllWebs["Website_Name"])
{
    SPList oList = oWebsite.Lists["MyList"];
    SPFieldCollection collFields = oList.Fields;

    string strNewFieldName = collFields.Add("MyNewColumn", 
        SPFieldType.Calculated, false);
    SPFieldCalculated strNewField =       
        (SPFieldCalculated)collFields[strNewFieldName];
    strNewField.Formula = "=[Column1]<[Column2]";
    strNewField.Update();

    SPView oView = oList.Views["MyView"];
    SPViewFieldCollection collViewFields = oView.ViewFields;
    collViewFields.Add(strNewFieldName);
    oView.Update();
}

Notes

Certains objets implémentent l'interface IDisposable , et vous devez éviter de conserver ces objets dans la mémoire après que qu'ils ne sont plus nécessaires. Pour plus d'informations sur les bonnes pratiques de codage, consultez Disposing Objects.

Cohérence de thread

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.

Voir aussi

Référence

SPFieldCalculated - Membres

Microsoft.SharePoint - Espace de noms

Partager via