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