Share via


NamedRange.Formula Property (2007 System)

Gets or sets the NamedRange control's formula in A1-style notation.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v9.0 (in Microsoft.Office.Tools.Excel.v9.0.dll)

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public Property Formula As Object
'Usage
Dim instance As NamedRange 
Dim value As Object 

value = instance.Formula

instance.Formula = value
[BrowsableAttribute(false)]
public Object Formula { get; set; }
[BrowsableAttribute(false)]
public:
property Object^ Formula {
    Object^ get ();
    void set (Object^ value);
}
public function get Formula () : Object 
public function set Formula (value : Object)

Property Value

Type: System.Object
The NamedRange control's formula in A1-style notation.

Remarks

If the NamedRange control contains a constant, this property returns the constant. If the NamedRange control is empty, this property returns an empty string. If the NamedRange control contains a formula, this property returns the formula as a string in the same format that would be displayed in the formula bar (including the equal sign).

If you set the value or formula of a NamedRange control to a date, Microsoft Office Excel checks to see whether that cell is already formatted with one of the date or time number formats. If not, Excel changes the number format to the default short date number format.

If the range is a one-dimensional or two-dimensional range, you can set the formula to an array of the same dimensions. Similarly, you can put the formula into an array.

Setting the formula for a multiple-cell NamedRange control fills all cells in the control with the formula.

Examples

The following code example sets the Formula property of a NamedRange control to calculate the sum of cells A1 through A5, uses the FormulaHidden property to hide the formula, and then calls the Calculate method to calculate the sum of the cells and place the sum in cell A6.

This example is for a document-level customization.

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", missing],
        "namedRange2");

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

.NET Framework Security

See Also

Reference

NamedRange Class

NamedRange Members

Microsoft.Office.Tools.Excel Namespace