NamedRange.FormulaR1C1Local-Eigenschaft

Artikel
08/10/2011

Ruft die Formel für das NamedRange-Steuerelement in Z1S1-Notation 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 FormulaR1C1Local As Object
    Get
    Set

Object FormulaR1C1Local { get; set; }

Eigenschaftswert

Typ: System.Object
Die Formel für das NamedRange-Steuerelement in Z1S1-Notation in der Sprache des Benutzers.

Hinweise

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

Wenn das NamedRange-Steuerelement eine Konstante enthält, gibt diese Eigenschaft diese 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, in dem sie 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, 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 FormulaR1C1-Eigenschaft unter Verwendung der Z1S1-Notation der Wert des NamedRange so festgelegt, dass er gleich der Quadratwurzel der Zelle A1 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 formulaR1C1LocalRange As Microsoft.Office.Tools.Excel.NamedRange

    Private Sub SetFormulaR1C1Local()
        formulaR1C1LocalRange = Me.Controls.AddNamedRange( _
            Me.Range("B1"), "formulaR1C1LocalRange")
        Me.Range("A1").Value2 = 1185921
        Me.formulaR1C1LocalRange.FormulaR1C1Local = "=SQRT(R1C1)"
        formulaR1C1LocalRange.Select()
    End Sub

Microsoft.Office.Tools.Excel.NamedRange formulaR1C1LocalRange;
private void SetFormulaR1C1Local()
{
    formulaR1C1LocalRange = this.Controls.AddNamedRange(
        this.Range["B1", missing], "formulaR1C1LocalRange");
    this.Range["A1", missing].Value2 = 1185921;
    this.formulaR1C1LocalRange.FormulaR1C1Local = "=SQRT(R1C1)";
    formulaR1C1LocalRange.Select();
}

.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