XmlMappedRange.Consolidate(Object, Object, Object, Object, Object) Methode

Definition

Namespace:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

Fasst Daten aus mehreren Bereichen auf mehreren Arbeitsblättern in einem XmlMappedRange-Steuerelement zusammen.

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

Parameter

Sources

Object

Die Quellen der Zusammenfassung als ein Array von Textbezugszeichenketten in Z1S1-Notation. Die Bezüge müssen den vollständigen Pfad der zusammenzufassenden Blätter enthalten.

Function

Object

Dies kann eine der folgenden XlConsolidationFunction Konstanten sein: xlAveragexlCountxlCountNumsxlMaxxlMinxlProductxlStDevxlStDevPxlSumxlVarxlVarP

TopRow

Object

true, um die Daten nach den Spaltenüberschriften in der obersten Zeile der Zusammenfassungsbereiche zusammenzufassen; false, um die Daten der Position nach zusammenzufassen. Der Standardwert ist false.

LeftColumn

Object

true, um die Daten nach den Zeilenüberschriften in der linken Spalte der Zusammenfassungsbereiche zusammenzufassen; false, um die Daten der Position nach zusammenzufassen. Der Standardwert ist false.

CreateLinks

Object

true, um bei der Zusammenfassung die Arbeitsblattverknüpfungen zu verwenden; false, um bei der Zusammenfassung die Daten zu kopieren. Der Standardwert ist false.

Gibt zurück

Object

Beispiele

Im folgenden Codebeispiel wird die Consolidate -Methode verwendet, um die Werte von Zelle A1 für Sheet2 und Zelle A1 in Sheet3 in zu XmlMappedRangeSheet1konsolidieren. Im Beispiel werden die Werte konsolidiert, indem die Werte zusammen hinzugefügt werden. In diesem Codebeispiel wird davon ausgegangen, dass Sheet1 einen XmlMappedRange namens CustomerLastNameCellenthält.

private void ConsolidateCells()
{
    Globals.Sheet2.Range["A1"].Value2 = 1710;
    Globals.Sheet3.Range["A1"].Value2 = 1240;

    string[] source = new string[] { "Sheet2!R1C1", "Sheet3!R1C1" };
    Globals.Sheet1.CustomerAddress1Cell.Consolidate(source, 
        Excel.XlConsolidationFunction.xlSum,
        false, false, false);
}

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

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.