Share via

NamedRange.Consolidate 方法

  • 發行項

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

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
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
)

參數

  • Sources
    型別：System.Object
    合併來源，為採用 R1C1 樣式標記的文字參照字串陣列。參照必須包括需要合併的工作表之完整路徑。
  • TopRow
    型別：System.Object
    true 表示根據合併範圍中頂端列的欄標題合併資料，否則為 false，表示依位置合併資料。預設值是 false。
  • LeftColumn
    型別：System.Object
    true 表示根據合併範圍中最左欄的列標題合併資料，否則為 false 表示依位置合併資料。預設值是 false。
  • CreateLinks
    型別：System.Object
    true 表示合併時使用工作表連結，否則為 false，表示合併時會複製資料。預設值是 false。

傳回值

型別：System.Object

備註

選擇性參數

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

範例

下列程式碼範例會將 B1 到 D10 的儲存格範圍設定為亂數，然後使用 Consolidate 方法將這個範圍合併到 NamedRange 控制項中。

這是示範文件層級自訂的範例。

    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


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

.NET Framework 安全性

請參閱

參考

NamedRange 介面

Microsoft.Office.Tools.Excel 命名空間