NamedRange.Formula Свойство (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Возвращает или задает формулу элемента управления NamedRange в нотации стиля A1.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public Property Formula As Object
'Применение
Dim instance As NamedRange
Dim value As Object

value = instance.Formula

instance.Formula = value

[BrowsableAttribute(false)]
public Object Formula { get; set; }

Значение свойства

Тип: System.Object
Формула элемента управления NamedRange в нотации стиля A1.

Заметки

Если элемент управления NamedRange содержит константу, это свойство возвращает константу. Если элемент управления NamedRange пуст, данное свойство возвращает пустую строку. Если элемент управления NamedRange содержит формулу, это свойство возвращает формулу как строку в том же формате, в котором она отображалась бы в строке формулы (включая знак равенства).

Если присвоить значению или формуле элемента управления NamedRange дату, Microsoft Office Excel проверит, назначен ли этой ячейке один из форматов даты или времени. Если нет, Excel заменяет числовой формат на используемый по умолчанию короткий формат даты.

Если диапазон является одномерным или двумерным, можно назначить формулу массиву такой же размерности. Подобным образом можно поместить формулу в массив.

При задании формулы для элемента управления NamedRange, состоящего из нескольких ячеек, этой формулой заполняются все его ячейки.

Примеры

В следующем примере кода свойству Formula элемента управления NamedRange присваивается формула вычисления суммы значений ячеек от A1 до A5, затем эта формула скрывается с помощью свойства FormulaHidden, послед чего вызывается метод Calculate для вычисления суммы значений ячеек и помещения этой суммы в ячейку A6.

В этом примере демонстрируется настройка уровня документа.

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

NamedRange Класс

NamedRange - члены

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через