Compartir a través de

XmlMappedRange.Consolidate (Método)

  • Artículo

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

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.
  • 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 utiliza el método Consolidate para consolidar los valores de la celda A1 de Sheet2 y de la celda A1 de Sheet3 en un control XmlMappedRange de Sheet1. En el ejemplo se consolidan los valores sumándolos. En este ejemplo de código se supone que Sheet1 contiene un control XmlMappedRange denominado CustomerLastNameCell.

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

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

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

Seguridad de .NET Framework

Vea también

Referencia

XmlMappedRange Interfaz

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