XmlMappedRange.Consolidate(Object, Object, Object, Object, Object) 方法

定義

命名空間:

Microsoft.Office.Tools.Excel

組件:

Microsoft.Office.Tools.Excel.dll

將多張工作表上多個範圍的資料合併到 XmlMappedRange 控制項中。

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

參數

Sources

Object

合併來源，為採用 R1C1 樣式標記的文字參照字串陣列。 參照必須包括需要合併的工作表之完整路徑。

Function

Object

可以為下列 XlConsolidationFunction 其中一個常數： xlAveragexlCountxlCountNumsxlMaxxlMinxlProductxlStDevxlStDevPxlSumxlVarxlVarP

TopRow

Object

true 表示根據合併範圍中頂端列的欄標題合併資料，否則為 false，表示依位置合併資料。 預設值是 false。

LeftColumn

Object

true 表示根據合併範圍中最左欄的列標題合併資料，否則為 false 表示依位置合併資料。 預設值是 false。

CreateLinks

Object

true 表示合併時使用工作表連結，否則為 false，表示合併時會複製資料。 預設值是 false。

傳回

Object

範例

下列程式代碼範例會 Consolidate 使用 方法，將上的 Sheet2 A1 單元格值和上的 A1 Sheet3 儲存格合併為 XmlMappedRange 上的 Sheet1。 此範例會藉由將值加在一起來合併值。 這個程式代碼範例假設 Sheet1 包含 XmlMappedRange 具名 CustomerLastNameCell的 。

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

備註

選擇性參數

如需選擇性參數的資訊，請參閱 Office 方案中的選擇性參數。