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 样式表示法表示的文本引用字符串的数组)。引用必须包含要合并的工作表的完整路径。
- Function
类型:System.Object
可以是下列 XlConsolidationFunction 常量之一:
xlAverage
xlCount
xlCountNums
xlMax
xlMin
xlProduct
xlStDev
xlStDevP
xlSum
xlVar
xlVarP
- TopRow
类型:System.Object
如果基于合并范围内首行中的列标题合并数据,则为 true;如果按位置合并数据,则为 false。默认值为 false。
- LeftColumn
类型:System.Object
如果基于合并范围内左列中的行标题合并数据,则为 true;如果按位置合并数据,则为 false。默认值为 false。
- CreateLinks
类型:System.Object
如果让合并功能使用工作表链接,则为 true;如果让合并功能复制数据,则为 false。默认值为 false。
返回值
备注
可选参数
有关可选参数的信息,请参见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"].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);
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。