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

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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 : xlAverage xlCount xlCountNums xlMax xlMin xlProduct xlStDev xlStDevP xlSum xlVar xlVarP

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

Cet exemple concerne une personnalisation au niveau du document.

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);
}

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

Remarques

Paramètres facultatifs

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

S’applique à