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

定義

命名空間:

Microsoft.Office.Tools.Excel

組件:

Microsoft.Office.Tools.Excel.dll

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

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

範例

下列程式代碼範例會將 B1 到 D10 之間的儲存格範圍設定為隨機數，然後使用 Consolidate 方法將此範圍合併成 NamedRange 控件。

此範例適用於檔層級自定義。

private void SetConsolidation()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1"],
        "namedRange1");

    Excel.Range Range1 = this.Range["B1", "D10"];
    Range1.Formula = "=rand()";

    string[] source = new string[] { "Sheet1!R1C2:R10C4" };
    namedRange1.Consolidate(source, Excel.XlConsolidationFunction.xlSum,
        false, false, false);
}

Private Sub SetConsolidation()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1"), _
        "namedRange1")

    Dim Range1 As Excel.Range = Me.Range("B1", "D10")
    Range1.Formula = "=rand()"

    Dim [source]() As String = {"Sheet1!R1C2:R10C4"}
    namedRange1.Consolidate([source], _
    Excel.XlConsolidationFunction.xlSum, False, False, False)

End Sub

備註

選擇性參數

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