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 解决方案中的可选参数。