Metodo NamedRange.Consolidate

Articolo
08/11/2011

Consolida dati da più intervalli su più fogli di lavoro nel controllo NamedRange.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
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
)

Parametri

Sources
Tipo: System.Object
Origini del consolidamento sotto forma di matrice di stringhe di riferimento di testo nella notazione R1C1.I riferimenti devono includere il percorso completo dei fogli da utilizzare nel consolidamento.

Function
Tipo: System.Object
Può essere una delle seguenti costanti di XlConsolidationFunction:
xlAverage
xlCount
xlCountNums
xlMax
xlMin
xlProduct
xlStDev
xlStDevP
xlSum
xlVar
xlVarP

TopRow
Tipo: System.Object
true per consolidare dati basati su titoli di colonna nella riga superiore degli intervalli di consolidamento; false per consolidare dati in base alla posizione.Il valore predefinito è false.

LeftColumn
Tipo: System.Object
true per consolidare dati basati su titoli di riga nella colonna sinistra degli intervalli di consolidamento; false per consolidare dati in base alla posizione.Il valore predefinito è false.

CreateLinks
Tipo: System.Object
true affinché il consolidamento utilizzi i collegamenti del foglio di lavoro; false affinché il consolidamento copi i dati.Il valore predefinito è false.

Valore restituito

Tipo: System.Object

Note

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito l'intervallo di celle da B1 a D10 viene impostato su numeri casuali. Viene quindi utilizzato il metodo Consolidate per consolidare questo intervallo in un controllo NamedRange.

Questo esempio è valido per una personalizzazione a livello di documento.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Share via