NamedRange.FormulaR1C1-Eigenschaft

Artikel
08/10/2011

Ruft die Formel für das Objekt in der Z1S1-Notation 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 FormulaR1C1 As Object
    Get
    Set

Object FormulaR1C1 { get; set; }

Eigenschaftswert

Typ: System.Object
Die Formel für das Objekt in Z1S1-Notation.

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 die 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 FormulaR1C1-Eigenschaft unter Verwendung der Z1S1-Notation der Wert des NamedRange so festgelegt, dass er gleich der Quadratwurzel der Zelle A1 ist.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

Private Sub SetFormulaR1C1()
    formulaR1C1Range = Me.Controls.AddNamedRange( _
        Me.Range("B1"), "formulaR1C1Range")
    Me.Range("A1").Value2 = 1185921
    Me.formulaR1C1Range.FormulaR1C1 = "=SQRT(R1C1)"
    formulaR1C1Range.Select()
End Sub

Microsoft.Office.Tools.Excel.NamedRange formulaR1C1Range;
private void SetFormulaR1C1()
{
    formulaR1C1Range = this.Controls.AddNamedRange(
        this.Range["B1", missing], "formulaR1C1Range");
    this.Range["A1", missing].Value2 = 1185921;
    this.formulaR1C1Range.FormulaR1C1 = "=SQRT(R1C1)";
    formulaR1C1Range.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