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 方法将 上的单元格 A1 和 上 Sheet2 单元格 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 解决方案中的可选参数。