Propriedade NamedRange.Formula

Artigo
08/01/2011

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

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

Sintaxe

'Declaração
Property Formula As Object
    Get
    Set

Object Formula { get; set; }

Valor de propriedade

Tipo: System.Object
O NamedRange a fórmula do controle na notação de estilo A1.

Comentários

Se o NamedRange controle contém uma constante, essa propriedade retornará a constante. Se o NamedRange controle estiver vazio, essa propriedade retorna uma seqüência de caracteres vazia. Se a NamedRange controle contém uma fórmula, essa propriedade retornará a fórmula como uma seqüência de caracteres no mesmo formato que seria exibido na barra de fórmulas (incluindo o sinal de igual).

Se você definir o valor ou fórmula de uma NamedRange o controle para uma data, Excel de Microsoft Office verifica para ver se essa célula já está formatada com um dos formatos de número data ou hora. Caso contrário, o Excel altera o formato de número 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.

A definição da fórmula para uma célula de várias NamedRange controle preenche todas as células no controle com a fórmula.

Exemplos

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

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

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

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