XmlMappedRange.Consolidate, méthode

Article
01/06/2014

Consolide les données de plusieurs plages de plusieurs feuilles de calcul dans un contrôle XmlMappedRange.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
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
)

Paramètres

Sources
Type : System.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
Type : System.Object
Il peut s'agir de l'une des constantes XlConsolidationFunction suivantes :
xlAverage
xlCount
xlCountNums
xlMax
xlMin
xlProduct
xlStDev
xlStDevP
xlSum
xlVar
xlVarP

TopRow
Type : System.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
Type : System.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
Type : System.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.

Valeur de retour

Type : System.Object

Notes

Paramètres optionnels

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

Exemples

L'exemple de code suivant utilise la méthode Consolidate pour consolider les valeurs de la cellule A1 de Sheet2 et la cellule A1 de Sheet3 dans un contrôle XmlMappedRange de Sheet1. L'exemple consolide les valeurs en les additionnant. Cet exemple de code suppose que Sheet1 contient un contrôle XmlMappedRange nommé 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"].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);
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

XmlMappedRange Interface

Microsoft.Office.Tools.Excel, espace de noms

Partager via