NamedRange.Consolidate (Método)

Consolida los datos de varios rangos de diversas hojas de cálculo en el control NamedRange.

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

Sintaxis

'Declaración
Function Consolidate ( _
    Sources As Object, _
    Function As Object, _
    TopRow As Object, _
    LeftColumn As Object, _
    CreateLinks As Object _
) As Object

Object Consolidate(
    Object Sources,
    Object Function,
    Object TopRow,
    Object LeftColumn,
    Object CreateLinks
)

Parámetros

• Sources
  Tipo: System.Object
  Los orígenes de la consolidación como matriz de cadenas de referencia de texto en notación de estilo F1C1.Las referencias deben incluir la ruta de acceso completa a las hojas que se van a consolidar.

• Function
  Tipo: System.Object
  Puede ser una de las siguientes constantes de XlConsolidationFunction:
  xlAverage
  xlCount
  xlCountNums
  xlMax
  xlMin
  xlProduct
  xlStDev
  xlStDevP
  xlSum
  xlVar
  xlVarP

• TopRow
  Tipo: System.Object
  true para consolidar los datos basándose en los títulos de columna en la fila superior de los rangos de consolidación; false para consolidar los datos por posición.El valor predeterminado es false.

• LeftColumn
  Tipo: System.Object
  Es true para consolidar los datos a partir de los títulos de fila en la columna izquierda de los rangos de consolidación y false para consolidar los datos por posición.El valor predeterminado es false.

• CreateLinks
  Tipo: System.Object
  Es true para que en la consolidación se utilicen vínculos de hoja de cálculo y false para que en la consolidación se copien los datos.El valor predeterminado es false.

Valor devuelto

Tipo: System.Object

Comentarios

Parámetros opcionales

Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.

Ejemplos

En el siguiente ejemplo de código se establece el rango de las celdas comprendidas entre la B1 y la D10 en número aleatorios y, a continuación, se utiliza el método Consolidate para consolidar este rango en un control NamedRange.

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

    Private Sub SetConsolidation()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), _
            "namedRange1")

        Dim Range1 As Excel.Range = Me.Range("B1", "D10")
        Range1.Formula = "=rand()"

        Dim [source]() As String = {"Sheet1!R1C2:R10C4"}
        namedRange1.Consolidate([source], _
        Excel.XlConsolidationFunction.xlSum, False, False, False)

    End Sub

private void SetConsolidation()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange1");

    Excel.Range Range1 = this.Range["B1", "D10"];
    Range1.Formula = "=rand()";

    string[] source = new string[] { "Sheet1!R1C2:R10C4" };
    namedRange1.Consolidate(source, Excel.XlConsolidationFunction.xlSum,
        false, false, false);
}

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

NamedRange Interfaz

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