通过

XmlMappedRange.Consolidate 方法

将多个工作表中的多个范围的数据合并到 XmlMappedRange 控件中。

命名空间：  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 解决方案中的可选参数。

示例

下面的代码示例使用 Consolidate 方法将 Sheet2 上的单元格 A1 的值和 Sheet3 上的单元格 A1 的值合并到 Sheet1 上的 XmlMappedRange 中。 该示例通过将值一起添加来合并这些值。 此代码示例假定 Sheet1 包含一个名为 CustomerLastNameCell 的 XmlMappedRange。

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

private void ConsolidateCells()
{
    Globals.Sheet2.Range["A1", missing].Value2 = 1710;
    Globals.Sheet3.Range["A1", missing].Value2 = 1240;

    string[] source = new string[] { "Sheet2!R1C1", "Sheet3!R1C1" };
    Globals.Sheet1.CustomerAddress1Cell.Consolidate(source, 
        Excel.XlConsolidationFunction.xlSum,
        false, false, false);
}

.NET Framework 安全性

请参见

参考

XmlMappedRange 接口

Microsoft.Office.Tools.Excel 命名空间