Propriedade NamedRange.FormulaR1C1

Artigo
01/09/2014

Obtém ou define a fórmula para o objeto, usando notação de R1C1-style.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Property FormulaR1C1 As Object

Object FormulaR1C1 { get; set; }

Valor de propriedade

Tipo: System.Object
A fórmula para o objeto, usando notação de R1C1-style.

Comentários

Usar essa propriedade em um controle de NamedRange que contém vários células fará com que uma exceção seja lançada.

Se a célula contém uma constante, retornos dessa propriedade a constante. Se a célula estiver vazia, essa propriedade retorna uma cadeia de caracteres vazia. Se a célula contém uma fórmula, retornos dessa propriedade a fórmula como uma cadeia de caracteres, no mesmo formato em que seria exibido na barra de fórmula (incluindo o sinal de igualdade).

Se você definir o valor ou a fórmula de uma célula em uma data, Microsoft Office Excel verifica se essa célula já está formatada com um dos formatos de número de data ou hora. Caso contrário, o formato de número é alterado para o número de formato de data curto padrão.

Se o intervalo é um intervalo unidimensional ou bidimensional, você pode definir a fórmula a uma matriz das mesmas dimensões. Da mesma forma, você pode colocar a fórmula em uma matriz.

Exemplos

O exemplo de código a seguir cria NamedRange e usar a propriedade de FormulaR1C1 para definir o valor de NamedRange para igualar a raiz quadrada da célula A1, como a notação R1C1 de usar especificada.

Este exemplo é para uma personalização de um documento nível.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via