Propriedade NamedRange.Formula

Artigo
01/09/2014

Obtém ou define a fórmula de controle de NamedRange na notação de A1-style.

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

Sintaxe

'Declaração
Property Formula As Object

Object Formula { get; set; }

Valor de propriedade

Tipo: System.Object
A fórmula de controle de NamedRange na notação de A1-style.

Comentários

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

Se você definir o valor ou a fórmula de um controle de NamedRange a 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 excel altera o formato de número ao 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.

Definindo a fórmula para vários uma célula NamedRange controle suficiências todas as células no controle com a fórmula.

Exemplos

O exemplo de código a seguir define a propriedade de Formula de um controle de NamedRange para calcular a soma das células A1 com o A5, usa a propriedade de FormulaHidden para ocultar a fórmula e em seguida, chame o método de Calculate para calcular a soma das células e colocar a soma na célula A6.

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

    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"],
        "namedRange2");

    namedRange1.Value2 = 5;
    namedRange2.Formula = "=SUM(A1:A5)";
    namedRange2.FormulaHidden = true;
    namedRange2.Calculate();
}

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