通过

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 命名空间