Freigeben über


XmlMappedRange.Consolidate-Methode

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

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

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

Parameter

  • Sources
    Typ: System.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.
  • TopRow
    Typ: System.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
    Typ: System.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
    Typ: System.Object
    true , um bei der Zusammenfassung die Arbeitsblattverknüpfungen zu verwenden; false, um bei der Zusammenfassung die Daten zu kopieren.Der Standardwert ist false.

Rückgabewert

Typ: System.Object

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel werden mithilfe der Consolidate-Methode die Werte der Zelle A1 auf Sheet2 und der Zelle A1 auf Sheet3 in einem XmlMappedRange auf Sheet1 zusammengefasst.Im Beispiel werden die Werte durch Addition der Werte zusammengefasst.In diesem Codebeispiel wird angenommen, dass Sheet1 einen XmlMappedRange mit dem Namen CustomerLastNameCell enthält.

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"].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);
}

.NET Framework-Sicherheit

Siehe auch

Referenz

XmlMappedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace