XmlMappedRange.Consolidate(Object, Object, Object, Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Excel

Ensamblado:

Microsoft.Office.Tools.Excel.dll

Consolida los datos de varios rangos de diversas hojas de cálculo en un control XmlMappedRange.

public object Consolidate (object Sources, object Function, object TopRow, object LeftColumn, object CreateLinks);

abstract member Consolidate : obj * obj * obj * obj * obj -> obj

Public Function Consolidate (Optional Sources As Object, Optional Function As Object, Optional TopRow As Object, Optional LeftColumn As Object, Optional CreateLinks As Object) As Object

Parámetros

Sources

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

Object

Puede ser una de las siguientes XlConsolidationFunction constantes: xlAveragexlCountxlCountNumsxlMaxxlMinxlProductxlStDevxlStDevPxlSumxlVarxlVarP

TopRow

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

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

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.

Devoluciones

Object

Ejemplos

En el ejemplo de código siguiente se usa el Consolidate método para consolidar los valores de la celda A1 en Sheet2 y la celda A1 en Sheet3 en un XmlMappedRange en Sheet1. En el ejemplo se consolidan los valores agregando los valores juntos. En este ejemplo de código se supone que Sheet1 contiene un objeto XmlMappedRange denominado CustomerLastNameCell.

private void ConsolidateCells()
{
    Globals.Sheet2.Range["A1"].Value2 = 1710;
    Globals.Sheet3.Range["A1"].Value2 = 1240;

    string[] source = new string[] { "Sheet2!R1C1", "Sheet3!R1C1" };
    Globals.Sheet1.CustomerAddress1Cell.Consolidate(source, 
        Excel.XlConsolidationFunction.xlSum,
        false, false, false);
}

Private Sub ConsolidateCells()
    Globals.Sheet2.Range("A1").Value2 = 1710
    Globals.Sheet3.Range("A1").Value2 = 1240

    Dim Source As String() = {"Sheet2!R1C1", "Sheet3!R1C1"}
    Globals.Sheet1.CustomerAddress1Cell.Consolidate(Source, _
        Excel.XlConsolidationFunction.xlSum, False, False, False)
End Sub

Comentarios

Parámetros opcionales

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