NamedRange.FormulaLocal-Eigenschaft

Artikel
08/10/2011

Ruft die Formel für das NamedRange-Steuerelement mithilfe der A1-Bezüge in der Sprache des Benutzers ab oder legt diese Formel fest.

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

Syntax

'Declaration
Property FormulaLocal As Object
    Get
    Set

Object FormulaLocal { get; set; }

Eigenschaftswert

Typ: System.Object
Die Formel für das NamedRange-Steuerelement mit A1-Bezügen in der Sprache des Benutzers.

Hinweise

Wenn diese Eigenschaft bei einem NamedRange-Steuerelement mit mehreren Zellen verwendet wird, wird eine Ausnahme ausgelöst.

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

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

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.

Beispiele

Im folgenden Codebeispiel wird ein NamedRange erstellt. Anschließend wird mithilfe der FormulaLocal-Eigenschaft der Wert des NamedRange so festgelegt, dass er gleich der Summe der Werte in den Zellen A1 und A2 ist. Die Formel wird entsprechend der Sprache des Systems lokalisiert, auf dem sie ausgeführt wird.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

Private Sub SetFormulaLocal()
    formulaLocalRange = Me.Controls.AddNamedRange( _
        Me.Range("B1"), "formualLocalRange")
    Me.Range("A1", "A2").Value2 = 2222
    Me.formulaLocalRange.FormulaLocal = "=Sum(A1+A2)"
End Sub

Microsoft.Office.Tools.Excel.NamedRange formulaLocalRange;
private void SetFormulaLocal()
{
    formulaLocalRange = this.Controls.AddNamedRange(
        this.Range["B1", missing], "formualLocalRange");
    this.Range["A1", "A2"].Value2 = 2222;
    this.formulaLocalRange.FormulaLocal = "=Sum(A1+A2)";
}

.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