Partager via


NamedRange.Consolidate, méthode

Consolide les données de plusieurs plages situées sur plusieurs feuilles de calcul dans le contrôle NamedRange.

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.
  • 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 affecte à la plage de cellules B1 à D10 des nombres aléatoires, puis utilise la méthode Consolidate pour consolider cette plage dans un contrôle NamedRange.

Cet exemple illustre une personnalisation au niveau du document.

    Private Sub SetConsolidation()
        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1"), _
            "namedRange1")

        Dim Range1 As Excel.Range = Me.Range("B1", "D10")
        Range1.Formula = "=rand()"

        Dim [source]() As String = {"Sheet1!R1C2:R10C4"}
        namedRange1.Consolidate([source], _
        Excel.XlConsolidationFunction.xlSum, False, False, False)

    End Sub

private void SetConsolidation()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange1");

    Excel.Range Range1 = this.Range["B1", "D10"];
    Range1.Formula = "=rand()";

    string[] source = new string[] { "Sheet1!R1C2:R10C4" };
    namedRange1.Consolidate(source, Excel.XlConsolidationFunction.xlSum,
        false, false, false);
}

Sécurité .NET Framework

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms