XmlMappedRange.Consolidate-Methode

Artikel
08/10/2011

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.

Function
Typ: System.Object
Kann eine der folgenden XlConsolidationFunction-Konstanten sein:
xlAverage
xlCount
xlCountNums
xlMax
xlMin
xlProduct
xlStDev
xlStDevP
xlSum
xlVar
xlVarP

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

XmlMappedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über