NamedRange.Formula-Eigenschaft

Artikel
08/10/2011

Ruft die Formel des NamedRange-Steuerelements in A1-Notation ab oder legt diese fest.

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

Syntax

'Declaration
Property Formula As Object
    Get
    Set

Object Formula { get; set; }

Eigenschaftswert

Typ: System.Object
Die Formel des NamedRange-Steuerelements in A1-Notation.

Hinweise

Wenn das NamedRange-Steuerelement eine Konstante enthält, gibt diese Eigenschaft die Konstante zurück. Wenn das NamedRange-Steuerelement leer ist, gibt diese Eigenschaft eine leere Zeichenfolge zurück. Wenn das NamedRange-Steuerelement eine Formel enthält, gibt diese Eigenschaft die Formel als Zeichenfolge in demselben Format zurück, das in der Bearbeitungsleiste dargestellt werden würde, einschließlich Gleichheitszeichen.

Wenn Sie den Wert oder die Formel eines NamedRange-Steuerelements auf ein Datum festlegen, überprüft Microsoft Office Excel, ob diese Zelle bereits in einem der Zahlenformate für Datum und Uhrzeit formatiert ist. Wenn dies nicht der Fall ist, ändert Excel das Zahlenformat in das Standarddatumsformat (Kurzform).

Wenn es sich bei dem Bereich um einen eindimensionalen oder zweidimensionalen Bereich handelt, können Sie die Formel auf ein Array mit denselben Dimensionen festlegen. Auf ähnliche Weise können Sie die Formel in ein Array einfügen.

Durch Festlegen der Formel für ein NamedRange-Steuerelement mit mehreren Zellen werden alle in diesem Steuerelement enthaltenen Zellen mit der Formel aufgefüllt.

Beispiele

Im folgenden Codebeispiel wird die Formula-Eigenschaft eines NamedRange-Steuerelements auf die Berechnung der Summe der Zellen A1 bis A5 festgelegt. Die Formel wird mithilfe der FormulaHidden-Eigenschaft ausgeblendet. Anschließend wird die Calculate-Methode aufgerufen, um die Summe der Zellen zu berechnen und diese Summe in die Zelle A6 einzufügen.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

.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