Propriedade NamedRange.FormulaR1C1

Artigo
08/01/2011

Obtém ou define a fórmula para o objeto, usando a notação de estilo L1C1.

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

Sintaxe

'Declaração
Property FormulaR1C1 As Object
    Get
    Set

Object FormulaR1C1 { get; set; }

Valor de propriedade

Tipo: System.Object
A fórmula para o objeto, usando a notação de estilo L1C1.

Comentários

Usando essa propriedade em um NamedRange o controle que contenha várias células causará uma exceção ser acionada.

Se a célula contiver uma constante, essa propriedade retorna a constante. Se a célula estiver vazia, essa propriedade retornará uma seqüência vazia. Se a célula contiver uma fórmula, essa propriedade retorna a fórmula como uma seqüência, no mesmo formato no qual ela seria exibida na barra de fórmulas (incluindo o sinal de igual).

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

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

Exemplos

O exemplo de código a seguir cria um NamedRange e usa o FormulaR1C1 propriedade para definir o valor do NamedRange igual a raiz quadrada da célula A1, conforme especificado, usando notação de L1C1.

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

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", missing], "formulaR1C1Range");
    this.Range["A1", missing].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áveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via