Share via

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"].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 安全性

請參閱

參考

XmlMappedRange 介面

Microsoft.Office.Tools.Excel 命名空間