Metodo XmlMappedRange.Consolidate

Articolo
08/11/2011

Consolida dati da più intervalli su più fogli di lavoro in un controllo XmlMappedRange.

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 viene utilizzato il metodo Consolidate per consolidare i valori della cella A1 sul foglio Sheet2 e della cella A1 sul foglio Sheet3 in un controllo XmlMappedRange incluso nel foglio Sheet1. Nell'esempio i valori vengono aggiunti ai fini del consolidamento. Nell'esempio si presuppone che il foglio Sheet1 contenga un controllo XmlMappedRange denominato 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);
}

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

XmlMappedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite