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

Статья
01/10/2014

Возвращает или задает формулу для объекта в нотации стиля R1C1.

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

Синтаксис

'Декларация
Property FormulaR1C1 As Object

Object FormulaR1C1 { get; set; }

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

Тип: System.Object
Формула для объекта в нотации стиля R1C1.

Заметки

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

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

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

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

Примеры

В следующем примере кода создается NamedRange, после чего свойство FormulaR1C1 используется для установки значения NamedRange равным квадратному корню из значения ячейки A1 в соответствии с нотацией R1C1.

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

Private formulaR1C1Range As Microsoft.Office.Tools.Excel.NamedRange

Private Sub SetFormulaR1C1()
    formulaR1C1Range = Me.Controls.AddNamedRange( _
        Me.Range("B1"), "formulaR1C1Range")
    Me.Range("A1").Value2 = 1185921
    Me.formulaR1C1Range.FormulaR1C1 = "=SQRT(R1C1)"
    formulaR1C1Range.Select()
End Sub

Microsoft.Office.Tools.Excel.NamedRange formulaR1C1Range;
private void SetFormulaR1C1()
{
    formulaR1C1Range = this.Controls.AddNamedRange(
        this.Range["B1"], "formulaR1C1Range");
    this.Range["A1"].Value2 = 1185921;
    this.formulaR1C1Range.FormulaR1C1 = "=SQRT(R1C1)";
    formulaR1C1Range.Select();
}

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

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

См. также

Ссылки

NamedRange Интерфейс

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

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