NamedRange.Formula (Propiedad)

Obtiene o establece la fórmula de un control NamedRange en notación de estilo A1.

Espacio de nombres:  Microsoft.Office.Tools.Excel
Ensamblado:  Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)

Sintaxis

'Declaración
Property Formula As Object
    Get
    Set
Object Formula { get; set; }

Valor de propiedad

Tipo: System.Object
La fórmula del control NamedRange en notación de estilo A1.

Comentarios

Si el control NamedRange contiene una constante, esta propiedad la devuelve. Si el control NamedRange está vacío, esta propiedad devuelve una cadena vacía. Si el control NamedRange contiene una fórmula, esta propiedad devuelve la fórmula como cadena, con el mismo formato con el que se mostraría en la barra de fórmulas, incluido el signo igual.

Si establece el valor o la fórmula de un control NamedRange en una fecha, Microsoft Office Excel comprueba si esa celda ya tiene uno de los formatos numéricos de fecha u hora. Si no, Excel cambia el formato numérico al formato numérico de fecha corta predeterminado.

Si el rango es unidimensional o bidimensional, puede establecer la fórmula como matriz de las mismas dimensiones. De forma similar, se puede colocar la fórmula en una matriz.

Si se establece la fórmula de un control NamedRange de varias celdas, se rellenan todas ellas con dicha fórmula.

Ejemplos

En el ejemplo siguiente de código, se establece la propiedad Formula de un control NamedRange para calcular la suma de las celdas A1 a A5, se utiliza la propiedad FormulaHidden para ocultar la fórmula y, a continuación, se llama al método Calculate para calcular la suma de las celdas y colocarla en la celda A6.

Se trata de un ejemplo para una personalización en el nivel del documento.

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

Seguridad de .NET Framework

Vea también

Referencia

NamedRange Interfaz

Microsoft.Office.Tools.Excel (Espacio de nombres)