Propriedade NamedRange.FormulaArray

Artigo
08/01/2011

Obtém ou define a fórmula de matriz de NamedRange de controle.

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

Sintaxe

'Declaração
Property FormulaArray As Object
    Get
    Set

Object FormulaArray { get; set; }

Valor de propriedade

Tipo: System.Object
A fórmula de matriz do NamedRange de controle.

Comentários

Essa propriedade retorna (ou pode ser definida como) uma única fórmula ou uma matriz.

Se o NamedRange controle não contém uma fórmula de matriz, essa propriedade retornará nulluma referência nula (Nothing no Visual Basic).

Se você usar essa propriedade para inserir uma fórmula de matriz, a fórmula deve usar o estilo de referência L1C1, não o estilo de referência A1.

Exemplos

O exemplo de código a seguir cria um NamedRange e usa o FormulaArray propriedade para definir o valor a NamedRange para ser igual à soma da matriz de células A1 até A3.

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

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

    Private Sub SetFormulaArray()
        formualArrayRange = Me.Controls.AddNamedRange( _
            Me.Range("B1"), "formualArrayRange")
        Me.Range("A1", "A3").Value2 = 3333
        Me.formualArrayRange.FormulaArray = "=Sum(R1C1:R3C1)"
    End Sub

Microsoft.Office.Tools.Excel.NamedRange formualArrayRange;
private void SetFormulaArray()
{
    formualArrayRange = this.Controls.AddNamedRange(
        this.Range["B1", missing], "formualArrayRange");
    this.Range["A1", "A3"].Value2 = 3333;
    this.formualArrayRange.FormulaArray = "=Sum(R1C1:R3C1)";
}

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