NamedRange.FormulaArray-Eigenschaft

Artikel
08/10/2011

Ruft die Arrayformel des NamedRange-Steuerelements ab oder legt diese fest.

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

Syntax

'Declaration
Property FormulaArray As Object
    Get
    Set

Object FormulaArray { get; set; }

Eigenschaftswert

Typ: System.Object
Die Arrayformel des NamedRange-Steuerelements.

Hinweise

Diese Eigenschaft gibt eine einzelne Formel oder ein Array zurück (oder kann auf eine einzelne Formel oder ein Array festgelegt werden).

Wenn das NamedRange-Steuerelement keine Arrayformel enthält, gibt diese Eigenschaft nullNULL-Verweis (Nothing in Visual Basic) zurück.

Wenn Sie mithilfe dieser Eigenschaft eine Arrayformel eingeben, muss für die Formel die Z1S1-Bezugsart und nicht die A1-Bezugsart verwendet werden.

Beispiele

Im folgenden Codebeispiel wird ein NamedRange erstellt. Anschließend wird mithilfe der FormulaArray-Eigenschaft der Wert des NamedRange so festgelegt, dass er gleich der Summe des Arrays der Zellen A1 bis A3 ist.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Share via