Partager via


NamedRange.Formula, propriété

Obtient ou définit la formule du contrôle NamedRange en notation A1.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Property Formula As Object
Object Formula { get; set; }

Valeur de propriété

Type : System.Object
Formule du contrôle NamedRange en notation A1.

Notes

Si le contrôle NamedRange contient une constante, cette propriété retourne la constante. Si le contrôle NamedRange est vide, cette propriété retourne une chaîne vide. Si le contrôle NamedRange contient une formule, cette propriété retourne la formule sous la forme d'une chaîne au même format que son format d'affichage dans la barre de formule (y compris le signe égal).

Si vous affectez une date à la valeur ou à la formule d'un contrôle NamedRange, Microsoft Office Excel vérifie si cette cellule est déjà mise en forme avec l'un des formats numériques de date ou d'heure. Sinon, Excel remplace le format par le format de date courte par défaut.

Si la plage est une plage à une ou deux dimensions, vous pouvez définir la formule en tant que tableau de mêmes dimensions. De la même façon, vous pouvez placer la formule dans un tableau.

La définition de la formule pour un contrôle NamedRange de plusieurs cellules remplit toutes les cellules du contrôle avec la formule.

Exemples

L'exemple de code suivant définit la propriété Formula d'un contrôle NamedRange pour calculer la somme des cellules A1 à A5, utilise la propriété FormulaHidden pour masquer la formule, puis appelle la méthode Calculate pour calculer la somme des cellules et placer le résultat dans la cellule A6.

Cet exemple illustre une personnalisation au niveau du document.

    Private Sub CalculateRange()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
            "namedRange1")

        Dim namedRange2 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A6"), _
            "namedRange2")

        namedRange1.Value2 = 5
        namedRange2.Formula = "=SUM(A1:A5)"
        namedRange2.FormulaHidden = True
        namedRange2.Calculate()
    End Sub

private void CalculateRange()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    Microsoft.Office.Tools.Excel.NamedRange namedRange2 =
        this.Controls.AddNamedRange(this.Range["A6"],
        "namedRange2");

    namedRange1.Value2 = 5;
    namedRange2.Formula = "=SUM(A1:A5)";
    namedRange2.FormulaHidden = true;
    namedRange2.Calculate();
}

Sécurité .NET Framework

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms