NamedRange.Formula - свойство

Статья
08/11/2011

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

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

Синтаксис

'Декларация
Property Formula As Object
    Get
    Set

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

Безопасность платформы .NET Framework

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

См. также

Ссылки

NamedRange Интерфейс

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

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