XmlMappedRange.Consolidate, méthode (System 2007)

Mise à jour : novembre 2007

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.v9.0 (dans Microsoft.Office.Tools.Excel.v9.0.dll)

Syntaxe

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

Dim instance As XmlMappedRange
Dim Sources As Object
Dim Function As Object
Dim TopRow As Object
Dim LeftColumn As Object
Dim CreateLinks As Object
Dim returnValue As Object

returnValue = instance.Consolidate(Sources, _
    Function, TopRow, LeftColumn, CreateLinks)

public 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 Fonctionnement des 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", 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);
}

Autorisations

• 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, classe

Membres XmlMappedRange

Microsoft.Office.Tools.Excel, espace de noms