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

Définition

Espace de noms:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

Consolide les données de plusieurs plages de plusieurs feuilles de calcul dans un contrôle 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

Paramètres

Sources

Object

Sources de la consolidation en tant que tableau de chaînes de référence de texte en notation R1C1. Les références doivent inclure le chemin d'accès complet des feuilles à consolider.

Function

Object

Il peut s’agir de l’une des constantes suivantes XlConsolidationFunction : xlAveragexlCountxlCountNumsxlMaxxlMinxlProductxlStDevxlStDevPxlSumxlVarxlVarP

TopRow

Object

true pour consolider des données en fonction des titres de colonne dans la ligne supérieure des plages de consolidation ; false pour consolider des données par position. La valeur par défaut est false.

LeftColumn

Object

true pour consolider des données en fonction des titres de ligne dans la colonne gauche des plages de consolidation ; false pour consolider des données par position. La valeur par défaut est false.

CreateLinks

Object

true pour que la consolidation utilise des liens de feuille de calcul ; false pour que la consolidation copie les données. La valeur par défaut est false.

Retours

Object

Exemples

L’exemple de code suivant utilise la Consolidate méthode pour consolider les valeurs de la cellule A1 sur Sheet2 et de la cellule A1 sur dans Sheet3 un XmlMappedRange sur Sheet1. L’exemple consolide les valeurs en ajoutant les valeurs ensemble. Cet exemple de code suppose que Sheet1 contient un XmlMappedRange nommé 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

Remarques

Paramètres facultatifs

Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.