This documentation is archived and is not being maintained.

Range.Formula Property 

Returns or sets the object's formula in A1-style notation and in the language of the macro.

Namespace: Microsoft.Office.Interop.Excel
Assembly: Microsoft.Office.Interop.Excel (in

Dim range1 As Range

Dim returnValue As Object
returnValue = range1.Formula

Dim sampleValue As Object
range1.Formula = sampleValue

property Object^ Formula{
	Object^ get();
	Void set(Object^);
public System.Object get_Formula();
public void set_Formula(System.Object);
function get Formula() : Object;
function set Formula(Object);

This property is not available for OLAP data sources.

If the cell contains a constant, this property returns the constant. If the cell is empty, this Formula property returns an empty string. If the cell contains a formula, the Formula 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 cell to a date, Microsoft Excel checks to see whether that cell is already formatted with one of the date or time number formats. If not, Microsoft Excel changes the number format to the default short date number format.

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

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

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, and Windows 2000

Target Platforms