SPFieldCalculated - Classe

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.

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();
}   

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