NamedRange.Consolidate, méthode

Article
08/10/2011

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.

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 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", missing],
        "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

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

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms

Partager via